コネクターエラーロギング

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

動作方法

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

構成

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

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

宛先コネクター

以下のコネクターアクションを使用して、コネクターエラーログを送信します：

Amazon Firehose - アクション：ログイベントをデリバリーストリームに送信
Amazon Firehose (Tealium Provided Credentials) - アクション：ログイベントをデリバリーストリームに送信
Amazon S3 - アクション：ログイベントを送信、アクション：ログイベント全体を送信
Confluent Kafka Connect - アクション：ログイベントを送信、アクション：ログイベント全体を送信
File Transfer Protocol (FTP, SFTP, FTPS) - アクション：ログイベントを送信、アクション：ログイベント全体を送信
Google Cloud Storage - アクション：ログイベントを送信、アクション：ログイベント全体を送信
Google Pub/Sub - アクション：トピックにログイベントを送信
Datadog - アクション：ログイベントを送信
New Relic - アクション：ログイベントを送信、アクション：ログイベント全体を送信
Microsoft Fabric Eventhouse - アクション：ログイベントを送信、アクション：ログイベント全体を送信
Webhook JDBC - アクション：ログイベントを送信

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

例示ログ

ログエントリの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.921+0000"
                  },
                  "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を見つけるには、コネクタテーブルでコネクタをクリックし、アクションをクリックし、最後に詳細をクリックします。
`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回目の呼び出しに対応します。