Event Notifications のロギング
IBM Cloud® Event Notifications などのサービスは、プラットフォームログを生成します。このログは、お客様のアカウント異常なアクティビティや重要なアクションを調査し、問題のトラブルシューティングを行うために使用できます。
プラットフォームサービスであるIBM Cloud Logs Routingを使用して、プラットフォームログの送信先を定義するテナントを設定することで、アカウント内のプラットフォームログを任意の送信先にルーティングできます。 詳細については、ログのルーティングについて を参照してください。
IBM Cloud Logsを使用すると、アカウントで生成され、IBM Cloud Logs RoutingによってIBM Cloud Logsインスタンスにルーティングされたプラットフォームのログを視覚化し、警告することができます。
プラットフォームのログが生成される場所
| リージョン | サポート対象 |
|---|---|
ダラス（us-south） |
はい |
シドニー（au-syd） |
はい |
フランクフルト（eu-de） |
はい |
マドリード (eu-es) |
はい |
ロンドン（eu-gb） |
はい |
トロント (ca-tor) |
はい |
東京（jp-tok） |
はい |
大阪 (jp-osa) |
はい |
サンパウロ (br-sao) |
はい |
モントリオール (ca-mon) |
はい |
ワシントンDC（us-east） |
はい |
in-che |
はい |
ムンバイ (in-mum) |
はい |
ログが送信される場所IBM Cloud Logs
Event Notificationsは、以下の表に示す地域のIBM Cloud Logsにプラットフォームのログを送信する。
ダラス（us-south） |
ワシントンDC（us-east） |
トロント (ca-tor) |
サンパウロ (br-sao) |
モントリオール (ca-mon) |
|---|---|---|---|---|
| はい | はい | はい | はい | はい |
東京（jp-tok） |
シドニー（au-syd） |
大阪 (jp-osa) |
in-che |
ムンバイ (in-mum) |
|---|---|---|---|---|
| はい | はい | はい | はい | はい |
フランクフルト（eu-de） |
ロンドン（eu-gb） |
マドリード (eu-es) |
|---|---|---|
| はい | はい | はい |
IBM Cloud Logs Routingによってログが送信される場所
Event Notificationsは、IBM Cloud Logs Routingにより、以下の表に示す地域でログを送信します。
ダラス（us-south） |
ワシントンDC（us-east） |
トロント (ca-tor) |
サンパウロ (br-sao) |
モントリオール (ca-mon) |
|---|---|---|---|---|
| はい | はい | はい | はい | はい |
| 東京（jp-tok） | シドニー（au-syd） | 大阪 (jp-osa) | in-che | ムンバイ (in-mum) | |---------------------|------------------|------------------|--------------------| | はい | はい | はい | はい | はい |
フランクフルト（eu-de） |
ロンドン（eu-gb） |
マドリード (eu-es) |
|---|---|---|
| はい | はい | はい |
ロギングの有効化
プラットフォーム・ログは、IBM Cloud のロギング対応サービスとプラットフォームから公開されるログです。 サービスによって送信されたログを受信するように、 IBM Cloud ログインスタンスを設定できます。 詳細は IBM Cloud Logs を参照。
ログの表示
Event Notifications インスタンスのプラットフォーム・ログを表示および分析するには、 IBM Cloud Logs Routing インスタンスがプロビジョニングされ、監視したい Event Notifications インスタンスが利用可能な同じリージョンにターゲットが設定されていることを確認します。
ログを表示するためにIBM Cloud Logs RoutingWeb UIを起動するには、「Web UIへの移動」を参照してください。
Observability ページからIBM Cloud Logsを起動する
IBM Cloud Logs UIの起動についての詳細は、IBM Cloud LogsのドキュメントでUIを起動する。 を参照してください
ログ・タイプごとのフィールド
各ログレコードに含まれるフィールドのリストについては、以下の表を参照のこと：
| フィールド | タイプ | 説明 |
|---|---|---|
logSourceCRN |
必須 | ログが公開されるアカウントを定義します。 |
saveServiceCopy |
必須 | 運用上の目的で IBM がレコードのコピーを保存するかどうかを定義します。 |
resourceGroupId |
必須 | Event Notifications インスタンスに関連付けられるリソース・グループを定義します。 |
message |
必須 | 生成されたログの説明。 |
msg_timestamp |
必須 | メッセージの UTC タイム・スタンプ。 |
messageID |
必須 | 生成されたログの ID。 |
resolution |
オプション | このログ・レコードを受信した場合の処理方法に関するガイダンス。 |
documentsURL |
オプション | このログ・レコードを受信した場合の処理方法に関する詳細情報。 |
sourceID |
必須 | Event Notifications サービスを通じて通知を送信する IBM Cloud サービスの CRN。 |
notificationID |
オプション | 宛先に送信される通知の ID です。 |
destinationID |
オプション | ステータスを報告しているデスティネーションのID。 |
level |
必須 | ログのタイプ。 有効な値は、INFO、WARN、ERRORです。 |
各プラットフォーム・ログに含まれるフィールドについては、 プラットフォーム・ログのフィールドを 参照してください
ログ・メッセージ
次の表は、 Event Notifications によって生成されるメッセージ ID の一覧である：
| メッセージID | ログ・タイプ | 説明 |
|---|---|---|
event-notifications.00001I |
INFO |
このメッセージは、ソースからの通知イベントが受信されたという情報を提供する。 CRNは IBM Cloud。 SourceID は、IBM Cloud サービスまたは人間にすることができます。例えば、以下のようになります。 |
event-notifications.00002I |
INFO |
このメッセージは、ソースから発生したイベントに通知IDが割り当てられたことを通知するものです。 |
event-notifications.00003I |
INFO |
このメッセージでは、トピックIDの一覧を通じて通知イベントが発行されたという情報が提供されます。 |
event-notifications.00004I |
INFO |
このメッセージは、通知リクエストがサブスクライバのリストによって処理されたという情報を提供する。 |
event-notifications.00006I |
INFO |
このメッセージは、有効なプラットフォームで利用可能なデバイスに関する情報を提供します。 有効なプラットフォームは、 [push_chrome、push_firefox、push_android、push_ios、push_safari] です |
event-notifications.00007I |
INFO |
このメッセージは、電話番号のリストにSMSが送信されるという情報を提供します。 |
event-notifications.00008I |
INFO |
このメッセージは、指定されたアドレスのリストにメールが送信されたことを通知するものです。 |
event-notifications.00009I |
INFO |
このメッセージは、ウェブフックが正常に処理されたことを通知し、ウェブフックAPIからのステータスコード200の応答を反映しています。 |
event-notifications.00010I |
INFO |
このメッセージは、通知イベントが指定された購読リストに送信されたことを通知するものです。 |
event-notifications.00011I |
INFO |
このメッセージは、通知イベントが指定された宛先リストに送信されたことを通知するものです。 |
event-notifications.00012I |
INFO |
このメッセージでは、通知が正常に処理されたデバイスの数とプラットフォームに関する情報が提供されます。 |
event-notifications.00013I |
INFO |
このメッセージでは、通知が正常に送信されたデバイスの数とプラットフォームに関する情報が提供されます。 |
event-notifications.00014I |
INFO |
このメッセージは、Slack宛てのメッセージが正常に送信されたことを通知し、Slack APIからのステータスコード200の応答を反映しています。 |
event-notifications.00015I |
INFO |
このメッセージは、通知が対応する宛先、デバイス、プラットフォームIDを持つプラットフォーム上のデバイスに配信されたという情報を提供します。 |
event-notifications.00015I |
INFO |
このメッセージは、ユーザーが通知を開いたデバイス、プラットフォーム、および宛先IDに関する情報を提供します。 |
event-notifications.00016I |
INFO |
このメッセージは、 Microsoft Teams 宛先が正常にサービスされたという情報を提供し、 Microsoft Teams API からのステータスコード 200 の応答を反映する。 |
event-notifications.00018I |
INFO |
このメッセージは、Pager Duty宛先が正常に処理されたことを示す情報を提供し、Pager Duty APIからのステータスコード200の応答を反映します。 |
event-notifications.00019I |
INFO |
このメッセージは Code Engineへの配信が正常に完了したことを通知し、 Code Engine からのステータスコード 200 での応答を反映しています。 |
event-notifications.00020I |
INFO |
このメッセージは、Service Now宛先への通知が正常に送信され、Service Now APIからのステータスコード200の応答が反映されたという情報を提供します。 |
event-notifications.00021I |
INFO |
このメッセージは、 IBM Cloud Object Storage が正常に提供されたという情報を提供し、 IBM Cloud Object Storage API からの応答を反映する。 |
event-notifications.00022I |
INFO |
このメッセージは、送信者から指定された受信者リストに送信された特定のサイズの電子メールに関する情報を提供する。 |
event-notifications.00023I |
INFO |
このメッセージは、送信者から指定された受信者リストに延期された特定のサイズの電子メールに関する情報を提供する。 |
event-notifications.00001W |
WARN |
このメッセージは、ソースに対してトピックが設定されていないため、ソースからの通知イベントが拒否されたことを警告するものです。 イベントをフィルタリングするために必要なトピックが欠落しています。 |
event-notifications.00002W |
WARN |
このメッセージは、ソースからの通知イベントが、どのトピックにもフィルタリングされていないため無効であるという警告を提供します。 |
event-notifications.00003W |
WARN |
このメッセージは、指定された購読者リストによって処理された通知要求が、宛先タイプに対して禁止されていることを警告するものです。 |
event-notifications.00004W |
WARN |
このメッセージは、購読者がいないため通知が配信されていないことを警告するものです。 |
event-notifications.00005W |
WARN |
このメッセージは、ウェブフックAPIがステータスコード404のエラー応答を返したことを警告しています。 |
event-notifications.00006W |
WARN |
このメッセージは、Slack API がステータスコード 404 の誤った応答を返したことを警告しています。 |
event-notifications.00007W |
WARN |
このメッセージは、 Microsoft Teams APIがステータスコード401で誤った応答を返したことを警告するものである。 |
event-notifications.00008W |
WARN |
このメッセージは、SMS番号が配信停止になっているため、SMSが配信されないという警告を提供します。 |
event-notifications.00010W |
WARN |
このメッセージは、ページャー・デューティAPIがステータスコード401で誤った応答を返したという警告を提供します。 |
event-notifications.00011W |
WARN |
このメッセージは Code Engineステータスコード 401 を含む誤った応答を返したことを警告するものです。 |
event-notifications.00012W |
WARN |
このメッセージは、Service Now APIがステータスコード401で誤った応答を返したことを警告しています。 |
event-notifications.00013W |
WARN |
このメッセージは、特定のサイズのメールがバウンスしたことを警告するもので、メールの真偽を確認する必要がある。 |
event-notifications.00001E |
ERROR |
このエラーメッセージは、無効なデバイスに通知が配信できなかったことを示しています。 |
event-notifications.00002E |
ERROR |
このエラーメッセージは、ウェブフックAPIがステータスコード404のエラー応答を返したことを示しています。 |
event-notifications.00003E |
ERROR |
このエラーメッセージは、デバイスとプラットフォームの認証エラーにより、通知のディスパッチに失敗したことを示しています。 |
event-notifications.00004E |
ERROR |
このエラーメッセージは、Slack API がステータスコード 401 を含むエラーレスポンスを返したことを示しています。 |
event-notifications.00005E |
ERROR |
このエラーメッセージは、デバイスとプラットフォームの BadDeviceToken エラーにより通知が配信できなかったことを示しています。 |
event-notifications.00006E |
ERROR |
このエラーメッセージは、 Microsoft Teams APIがステータスコード401の誤ったレスポンスを返したことを示している。 |
event-notifications.00008E |
ERROR |
このエラーメッセージは、Pager Duty APIがステータスコード401でエラー応答を返したことを示しています。 |
event-notifications.00009E |
ERROR |
このエラーメッセージは、 Code Engineステータスコード 401 を含むエラー応答を返したことを示しています。 |
event-notifications.00010E |
ERROR |
このエラーメッセージは、Service Now APIがステータスコード401のエラー応答を返したことを示しています。 |
サービスによって生成されたログをリストします
インスタンスに対して生成されているすべてのログを表示したい場合は、サブシステム下のレフトナビから Event Notifications インスタンスの guid を選択し、検索バーでソースを検索します。
通知要求のログをリストします
サービスまたはソースから Event Notifications サービスへのリクエストに対して生成される通知IDがわかっている場合、 IBM Cloud Logs で次のクエリーを使用して、その特定の通知IDのすべてのログをリストします：
<notification Id>