AWS X-Ray

Availability

Available since Cinnamon 2.16.1

Cinnamon doesn’t support the OTLP protocol at the moment, but luckily AWS OTel Collector supports Zipkin protocol via the Zipkin receiver. In order to push traces to the AWS X-Ray console, it uses the awsxray exporter.

Follow the steps on the Zipkin setup instructions page to setup your application to produce traces in Zipkin format. Note that you will need to provide a Zipkin URL pointing to the AWS OTel Collector endpoint, e.g.

Example
cinnamon.opentracing {
  zipkin {
    url-connection {
      endpoint = "http://my.zipkin.host:9411/api/v2/spans"
      encoding = "proto3"
    }
  }
}

AWS X-Ray supports only a specific trace ID format that has to have timestamps encoded in it. In order to enable trace ID format compatible with AWS X-Ray, and then enable AWS X-Ray trace ID format:

Example
cinnamon.opentracing {
  tracer {
    aws-xray-trace-id-format = on
  }
}
Note

Only Jaeger and Zipkin reporters support the AWS X-Ray trace ID format setting at the moment. Datadog or any other custom reporter do not support this setting it out of the box.