Attribute Formats

The traces and logs endpoints use the OpenTelemetry typed attribute format for all attributes on resources, scopes, spans, span events, and log records. The log record body field also uses this format.

The errors endpoint does not use this format. Error attributes are flat key-value objects (e.g. { "http.method": "GET" }). See the error attributes page for details.

Attribute Array

Attributes are represented as an array of key-value objects:

[
    {
        "key": "http.method",
        "value": {
            "stringValue": "GET"
        }
    },
    {
        "key": "http.status_code",
        "value": {
            "intValue": 200
        }
    },
    {
        "key": "error",
        "value": {
            "boolValue": true
        }
    }
]

Each object has a key (string) and a value object containing exactly one typed field.

Value Types

This same value format is also used for the log record body field. Most log entries use stringValue for plain text messages, but structured data can be represented using kvlistValue or arrayValue.

arrayValue

A list of typed values:

{
    "key": "tags",
    "value": {
        "arrayValue": {
            "values": [
                { "stringValue": "web" },
                { "stringValue": "production" }
            ]
        }
    }
}

kvlistValue

An associative list of key-value pairs, where each value is itself a typed value:

{
    "key": "http.request.headers",
    "value": {
        "kvlistValue": {
            "values": [
                { "key": "Content-Type", "value": { "stringValue": "application/json" } },
                { "key": "Accept", "value": { "stringValue": "text/html" } }
            ]
        }
    }
}