Connector error logging

Connector error logging is in Early Access and is only available to select customers. If you are interested in trying this feature, contact your Tealium Support representative.

How it works

The connector error logging feature generates JSON-formatted error logs and sends them to your preferred log management vendor. You can configure alerts with your vendor to quickly detect and resolve connector issues, helping prevent disruptions or data loss.

Setup

Provide the following information to your Customer Success Manager:

A list of connector names that you want to monitor.
A list of destinations that you want to stream logs to.

Destination connectors

Use any of the following connector actions to send connector error logs:

Amazon Firehose - Action: Send Log Event to Delivery Stream
Amazon Firehose (Tealium Provided Credentials) - Action: Send Log Event to Delivery Stream
Google Cloud Storage - Action: Send Log Event
Google Pub/Sub - Action: Send Log Event to Topic
Datadog - Action: Send Log Event
Webhook JDBC - Action: Send Log Event

Each of these connectors has a dedicated action for sending log streaming activity to the vendor.

Example log

The JSON payload for log entries will resemble the following:

{
  "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.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"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Connector log parameters

The following table lists all available parameters in the connector errors log file:

Parameter	Description
`logger`	The instance of logging utility used to log events, errors, and information.
`account`	The account where the destination connector is configured.
`profile`	The profile where the destination connector is configured.
`customId`	The action ID of the connector. To find the Action ID for an action, click the connector in the Connectors table, then click the action, and finally click Details.
`severityNumber`	The severity level of a log message.
`severityText`	The text description of the severity level of a log event.
`connectorType`	The connector vendor name.
`groupId`	This identifier is used to group together logs that are associated with a particular action or entity. This can uniquely identify and track logs related to a specific connector action or connector.
`result.executionTimeMs`	The duration, in milliseconds, taken to execute a specific connector action. This value provides insight into the performance of the connector action.
`result.status`	Indicates the outcome of the execution for a given connector action. It categorizes the final state of the connector action and can have values such as “SUCCESS” or “FAILURE.”
`result.failure.code.name`	The name of a specific error code that describes the nature of a failure encountered during the execution of a connector action. This error code name provides a high-level description of the issue, which can help in identifying and categorizing the types of errors occurring during the connector action executions.
`result.failure.code.id`	a unique identifier for a specific type of failure code encountered during the execution of a connector action. This identifier is used to provide a more structured and standardized way of logging and analyzing different types of errors.
`actionType`	The type of action that was performed during the execution of a connector. It categorizes the nature of the action being recorded in the log, indicating what specific operations were carried out.
`streamType`	Whether the action is an event connector action or visitor connector action. Possible values are `EVENT` or `VISITOR`.
`result.failure.errorsCount`	The total number of individual errors encountered during the execution of a connector action that resulted in a failure.
`result.failure.code.description`	A descriptive message related to the specific error that was encountered during the execution of a connector action.
`recordSendDateTime`	The date and time when a particular log record was sent or transmitted.
`actionsCount`	The total number of actions that have been executed or initiated during a particular log event.
`dimension`	A string value that can be provided by the submitter that specifies a particular aspect or category of the log entry. The dimension field is generally used for technical purposes and is filled in by the agent before sending the message to the log destination.
`timestamp`	The time when the log event occurred.
`visitorId`	The `tealium_visitor_id` of the visitor who performed the logged action. For batch actions and connectors, only one visitor ID from the batch is referenced.
`http.0.response.body`	The body of the HTTP response received from a request.
`result.failure.error.0.message`	An error message that describes a specific failure encountered during the execution of an action within Tealium’s systems. This field specifically captures details about an error that occurred, providing a description that can help diagnose and address the issue.
`http.0.response.statusCode`	The HTTP status code of the response received from an HTTP request made as part of a connector action, such as `200` for a successful request, `404` for a “Not Found” error, or `500` for an internal server error.
`http.0.executionTimeMs`	The amount of time, measured in milliseconds, that it took for the HTTP request to be executed and receive a response during a connector action.
`result.failure.error.0.count`	The count of a specific error type that has occurred during the execution of a connector action.

The number in a parameter name (for example, http.0.executionTimeMs) represents the sequence of HTTP calls made to the connector, starting from zero. If multiple HTTP calls occur, the number increments with each request, distinguishing parameters from different calls in the log. For example, http.0.executionTimeMs corresponds to the first call, http.1.executionTimeMs to the second call, http.2.executionTimeMs to the third call, and so on.