Exporting traces to AWS X-Ray

Document updated on Sep 15, 2019

AWS X-Ray is a service offered by Amazon that provides an end-to-end view of requests as they travel through your application, and shows a map of your application’s underlying components.

The Opencensus exporter allows you export data to AWS X-Ray. Enabling it only requires you to add the xray exporter in the opencensus module.

The following configuration snippet sends data to your X-Ray:

{
  "extra_config": {
    "telemetry/opencensus": {
      "exporters": {
        "xray": {
          "version": "latest",
          "region": "eu-west-1",
          "use_env": false,
          "access_key_id": "myaccesskey",
          "secret_access_key": "mysecretkey"
        }
      }
    }
  }
}

• version (string): The version of the running application that is reporting data. Defaults to KrakenD-opencensus.
• region (string): The AWS geographical region.
• use_env (boolean): When true the AWS credentials (access_key_id and secret_access_key) are taken from environment vars. Don’t specify them then.
• access_key_id (string): Your access key ID provided by Amazon. Needed when use_env is unset or set to false.
• secret_access_key (string): Your secret access key provided by Amazon. Needed when use_env is unset or set to false.

See also the additional settings of the Opencensus module that can be declared.