コネクターエラーログ | ログストリーミング

コネクターエラーログはアーリーアクセス中であり、選ばれた顧客のみが利用可能です。この機能を試してみたい場合は、Tealiumサポート担当者に連絡してください。

動作原理

コネクターエラーログ機能は、JSON形式のエラーログを生成し、お好みのログ管理ベンダーに送信します。ベンダーでアラートを構成することにより、コネクターの問題を迅速に検出して解決することができ、中断やデータ損失を防ぐのに役立ちます。

構成

カスタマーサクセスマネージャーに以下の情報を提供してください：

監視したいコネクターの名前のリスト。
ログをストリーミングする宛先のリスト。

宛先コネクター

以下の宛先にコネクターエラーをストリーミングできます：

Amazon Firehose - アクション：ログイベントをデリバリーストリームに送信。
Amazon Firehose (Tealium Provided Credentials) - アクション：ログイベントをデリバリーストリームに送信。
Google Pub/Sub - アクション：ログイベントをトピックに送信。
DataDog - アクション：ログイベントを送信。
Webhook - アクション：HTTPリクエストを介してログイベントを送信。

これらのコネクターは、それぞれベンダーにログストリーミング活動を送信する専用のアクションを持っています。

例のログ

ログエントリのJSONペイロードは以下のようになります：

{
  "resourceLogs": [
    {
      "resource": {
        "attributes": [
          {
            "value": {
              "stringValue": "connector-errors"
            },
            "key": "logger"
          },
          {
            "value": {
              "stringValue": "ACCOUNT_NAME"
            },
            "key": "account"
          },
          {
            "value": {
              "stringValue": "PROFILE_NAME"
            },
            "key": "profile"
          },
          {
            "value": {
              "stringValue": "12345678-1234-1234-1234-123456789012"
            },
            "key": "customId"
          }
        ]
      },
      "scopeLogs": [
        {
          "scope": {},
          "logRecords": [
            {
              "severityNumber": 17,
              "severityText": "ERROR",
              "attributes": [
                {
                  "value": {
                    "stringValue": "webhook"
                  },
                  "key": "connectorType"
                },
                {
                  "value": {
                    "stringValue": "404 Not Found"
                  },
                  "key": "http.0.response.body"
                },
                {
                  "value": {
                    "stringValue": "Error: received non-successful http response status = 404"
                  },
                  "key": "result.failure.error.0.message"
                },
                {
                  "value": {
                    "stringValue": "e71684df-90e6-4c4d-8cb2-695da67402a0"
                  },
                  "key": "groupId"
                },
                {
                  "value": {
                    "intValue": "368"
                  },
                  "key": "result.executionTimeMs"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.error.0.count"
                },
                {
                  "value": {
                    "stringValue": "FAILURE"
                  },
                  "key": "result.status"
                },
                {
                  "value": {
                    "stringValue": "API Error"
                  },
                  "key": "result.failure.code.name"
                },
                {
                  "value": {
                    "intValue": "404"
                  },
                  "key": "http.0.response.statusCode"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.code.id"
                },
                {
                  "value": {
                    "stringValue": "send_events"
                  },
                  "key": "actionType"
                },
                {
                  "value": {
                    "intValue": "226"
                  },
                  "key": "http.0.executionTimeMs"
                },
                {
                  "value": {
                    "stringValue": "EVENT"
                  },
                  "key": "streamType"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.errorsCount"
                },
                {
                  "value": {
                    "stringValue": "An error occurred communicating with the vendor"
                  },
                  "key": "result.failure.code.description"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.921+0000"
                  },
                  "key": "recordSendDateTime"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "actionsCount"
                },
                {
                  "value": {
                    "stringValue": "LOG_LEVEL_ERROR"
                  },
                  "key": "dimension"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.920978481Z"
                  },
                  "key": "timestamp"
                },
                {
                  "value": {
                    "stringValue": "5be887275efa4ea08137f3ea8b253e59"
                  },
                  "key": "visitorId"
                }
              ]
            },
            {
              "severityNumber": 17,
              "severityText": "ERROR",
              "attributes": [
                {
                  "value": {
                    "stringValue": "webhook"
                  },
                  "key": "connectorType"
                },
                {
                  "value": {
                    "stringValue": "404 Not Found"
                  },
                  "key": "http.0.response.body"
                },
                {
                  "value": {
                    "stringValue": "Error: received non-successful http response status = 404"
                  },
                  "key": "result.failure.error.0.message"
                },
                {
                  "value": {
                    "stringValue": "e71684df-90e6-4c4d-8cb2-695da67402a0"
                  },
                  "key": "groupId"
                },
                {
                  "value": {
                    "intValue": "368"
                  },
                  "key": "result.executionTimeMs"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.error.0.count"
                },
                {
                  "value": {
                    "stringValue": "FAILURE"
                  },
                  "key": "result.status"
                },
                {
                  "value": {
                    "stringValue": "API Error"
                  },
                  "key": "result.failure.code.name"
                },
                {
                  "value": {
                    "intValue": "404"
                  },
                  "key": "http.0.response.statusCode"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.code.id"
                },
                {
                  "value": {
                    "stringValue": "send_events"
                  },
                  "key": "actionType"
                },
                {
                  "value": {
                    "intValue": "226"
                  },
                  "key": "http.0.executionTimeMs"
                },
                {
                  "value": {
                    "stringValue": "EVENT"
                  },
                  "key": "streamType"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.errorsCount"
                },
                {
                  "value": {
                    "stringValue": "An error occurred communicating with the vendor"
                  },
                  "key": "result.failure.code.description"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.921+0000"
                  },
                  "key": "recordSendDateTime"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "actionsCount"
                },
                {
                  "value": {
                    "stringValue": "LOG_LEVEL_ERROR"
                  },
                  "key": "dimension"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.920978481Z"
                  },
                  "key": "timestamp"
                },
                {
                  "value": {
                    "stringValue": "5be887275efa4ea08137f3ea8b253e59"
                  },
                  "key": "visitorId"
                }
              ]
            },
            {
              "severityNumber": 17,
              "severityText": "ERROR",
              "attributes": [
                {
                  "value": {
                    "stringValue": "webhook"
                  },
                  "key": "connectorType"
                },
                {
                  "value": {
                    "stringValue": "404 Not Found"
                  },
                  "key": "http.0.response.body"
                },
                {
                  "value": {
                    "stringValue": "Error: received non-successful http response status = 404"
                  },
                  "key": "result.failure.error.0.message"
                },
                {
                  "value": {
                    "stringValue": "e71684df-90e6-4c4d-8cb2-695da67402a0"
                  },
                  "key": "groupId"
                },
                {
                  "value": {
                    "intValue": "368"
                  },
                  "key": "result.executionTimeMs"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.error.0.count"
                },
                {
                  "value": {
                    "stringValue": "FAILURE"
                  },
                  "key": "result.status"
                },
                {
                  "value": {
                    "stringValue": "API Error"
                  },
                  "key": "result.failure.code.name"
                },
                {
                  "value": {
                    "intValue": "404"
                  },
                  "key": "http.0.response.statusCode"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.code.id"
                },
                {
                  "value": {
                    "stringValue": "send_events"
                  },
                  "key": "actionType"
                },
                {
                  "value": {
                    "intValue": "226"
                  },
                  "key": "http.0.executionTimeMs"
                },
                {
                  "value": {
                    "stringValue": "EVENT"
                  },
                  "key": "streamType"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "result.failure.errorsCount"
                },
                {
                  "value": {
                    "stringValue": "An error occurred communicating with the vendor"
                  },
                  "key": "result.failure.code.description"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.921+0000"
                  },
                  "key": "recordSendDateTime"
                },
                {
                  "value": {
                    "intValue": "1"
                  },
                  "key": "actionsCount"
                },
                {
                  "value": {
                    "stringValue": "LOG_LEVEL_ERROR"
                  },
                  "key": "dimension"
                },
                {
                  "value": {
                    "stringValue": "2024-12-03T19:26:44.920978481Z"
                  },
                  "key": "timestamp"
                },
                {
                  "value": {
                    "stringValue": "5be887275efa4ea08137f3ea8b253e59"
                  },
                  "key": "visitorId"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

{
  "stringValue": "2024-12-03T19:26:44.920978952Z"
},
"key": "timestamp"
},
{
  "value": {
    "stringValue": "765dcbbd51e9417e80f76162b656ca65"
  },
  "key": "visitorId"
}
]
},
{
  "severityNumber": 17,
  "severityText": "ERROR",
  "attributes": [
    {
      "value": {
        "stringValue": "webhook"
      },
      "key": "connectorType"
    },
    {
      "value": {
        "stringValue": "404 Not Found"
      },
      "key": "http.0.response.body"
    },
    {
      "value": {
        "stringValue": "Error: received non-successful http response status = 404"
      },
      "key": "result.failure.error.0.message"
    },
    {
      "value": {
        "stringValue": "e71684df-90e6-4c4d-8cb2-695da67402a0"
      },
      "key": "groupId"
    },
    {
      "value": {
        "intValue": "368"
      },
      "key": "result.executionTimeMs"
    },
    {
      "value": {
        "intValue": "1"
      },
      "key": "result.failure.error.0.count"
    },
    {
      "value": {
        "stringValue": "FAILURE"
      },
      "key": "result.status"
    },
    {
      "value": {
        "stringValue": "API Error"
      },
      "key": "result.failure.code.name"
    },
    {
      "value": {
        "intValue": "404"
      },
      "key": "http.0.response.statusCode"
    },
    {
      "value": {
        "intValue": "1"
      },
      "key": "result.failure.code.id"
    },
    {
      "value": {
        "stringValue": "send_events"
      },
      "key": "actionType"
    },
    {
      "value": {
        "intValue": "226"
      },
      "key": "http.0.executionTimeMs"
    },
    {
      "value": {
        "stringValue": "EVENT"
      },
      "key": "streamType"
    },
    {
      "value": {
        "intValue": "1"
      },
      "key": "result.failure.errorsCount"
    },
    {
      "value": {
        "stringValue": "An error occurred communicating with the vendor"
      },
      "key": "result.failure.code.description"
    },
    {
      "value": {
        "stringValue": "2024-12-03T19:26:44.921+0000"
      },
      "key": "recordSendDateTime"
    },
    {
      "value": {
        "intValue": "1"
      },
      "key": "actionsCount"
    },
    {
      "value": {
        "stringValue": "LOG_LEVEL_ERROR"
      },
      "key": "dimension"
    },
    {
      "value": {
        "stringValue": "2024-12-03T19:26:44.920978082Z"
      },
      "key": "timestamp"
    },
    {
      "value": {
        "stringValue": "e3213ebd8e444418aed0d41f9eaa0b0f"
      },
      "key": "visitorId"
    }
  ]
}
]
}
]
}
]
}

コネクターログパラメータ

以下の表は、コネクターエラーログファイルで利用可能なすべてのパラメータをリストしています：

パラメータ	説明
`logger`	イベント、エラー、情報を記録するために使用されるロギングユーティリティのインスタンス。
`account`	送信先コネクタが構成されているアカウント。
`profile`	送信先コネクタが構成されているプロファイル。
`customId`	コネクタのアクションID。アクションIDを見つけるには、Connectors テーブルでコネクタをクリックし、アクションをクリックし、最後に Details をクリックします。
`severityNumber`	ログメッセージの重大度レベル。
`severityText`	ログイベントの重大度レベルのテキスト説明。
`connectorType`	コネクタのベンダー名。
`groupId`	この識別子は、特定のアクションまたはエンティティに関連するログをグループ化するために使用されます。これにより、特定のコネクタアクションまたはコネクタに関連するログを一意に識別し、追跡することができます。
`result.executionTimeMs`	特定のコネクタアクションの実行にかかった時間（ミリ秒）。この値は、コネクタアクションのパフォーマンスに関する洞察を提供します。
`result.status`	与えられたコネクタアクションの実行結果を示します。コネクタアクションの最終状態を分類し、「SUCCESS」または「FAILURE」などの値を持つことができます。
`result.failure.code.name`	コネクタアクションの実行中に遭遇した失敗の性質を説明する特定のエラーコードの名前。このエラーコード名は、コネクタアクションの実行中に発生するエラーの種類を特定し、分類するのに役立つ高レベルの説明を提供します。
`result.failure.code.id`	コネクタアクションの実行中に遭遇した特定の失敗コードタイプの一意の識別子。この識別子は、異なるタイプのエラーをログ記録および分析するためのより構造化された標準化された方法を提供するために使用されます。
`actionType`	コネクタの実行中に行われたアクションのタイプ。ログに記録されているアクションの性質を分類し、どのような具体的な操作が行われたかを示します。
`streamType`	アクションがイベントコネクタアクションか訪問コネクタアクションかを示します。可能な値は `EVENT` または `VISITOR` です。
`result.failure.errorsCount`	失敗に終わったコネクタアクションの実行中に遭遇した個々のエラーの総数。
`result.failure.code.description`	コネクタアクションの実行中に遭遇した特定のエラーに関連する説明メッセージ。
`recordSendDateTime`	特定のログレコードが送信または転送された日時。
`actionsCount`	特定のログイベント中に実行または開始されたアクションの総数。
`dimension`	ログエントリの特定の側面またはカテゴリを指定するために提出者によって提供される文字列値。dimension フィールドは一般的に技術的な目的で使用され、エージェントによってログの送信先にメッセージを送る前に記入されます。
`timestamp`	ログイベントが発生した時間。
`visitorId`	ログされたアクションを実行した訪問の `tealium_visitor_id`。バッチアクションおよびコネクタの場合、バッチからの訪問IDが1つだけ参照されます。
`http.0.response.body`	リクエストから受け取ったHTTPレスポンスの本文。
`result.failure.error.0.message`	Tealiumのシステム内でアクションの実行中に遭遇した特定の失敗を説明するエラーメッセージ。このフィールドは、発生したエラーについての詳細を特に捉え、問題の診断と対処に役立つ説明を提供します。
`http.0.response.statusCode`	コネクタアクションの一環として行われたHTTPリクエストから受け取ったレスポンスのHTTPステータスコード。たとえば、成功したリクエストの場合は `200`、“Not Found” エラーの場合は `404`、内部サーバーエラーの場合は `500` です。
`http.0.executionTimeMs`	コネクタアクション中にHTTPリクエストが実行され、レスポンスを受け取るのにかかった時間（ミリ秒単位）。
`result.failure.error.0.count`	コネクタアクションの実行中に発生した特定のエラータイプの回数。

パラメータ名に含まれる数字（例：http.0.executionTimeMs）は、コネクタへのHTTP呼び出しのシーケンスをゼロから始めて表します。複数のHTTP呼び出しが発生する場合、各リクエストで数字が増加し、ログ内の異なる呼び出しからのパラメータを区別します。たとえば、http.0.executionTimeMsは最初の呼び出し、http.1.executionTimeMsは2回目の呼び出し、http.2.executionTimeMsは3回目の呼び出しに対応します。