@medipass/propagator-aws-xray

OpenTelemetry Propagator AWS Xray

OpenTelemetry AWS Xray propagator provides HTTP header propagation for systems that are using AWS Xray HTTP header format.

Example Tracing Header:

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

Format: X-Amzn-Trace-Id: Root=1-{trace-id-1}-{trace-id-2};Parent={span-id};Sampled={flags}

• {trace-id-1}
  • 32-bit number in base16 format, encoded from time(second) when created.
  • Can be referred: AWS Xray Trace ID
• {trace-id-2}
  • 96-bit random number in base16 format
• {span-id}
  • 64-bit random number in base16 format.
• {flags}
  • One byte bitmap, as two hex digits.
  • Can be referred: JavaScript TraceFlags

Example of usage (will be added after published):

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.9.0

:boom: Breaking Change

• opentelemetry-api, opentelemetry-exporter-prometheus, opentelemetry-metrics
  • #1120 feat: add the UpDownCounter instrument (@mayurkale22)
  • #1126 feat!: remove label keys as they are no longer part of the spec (@naseemkullah)
• opentelemetry-api, opentelemetry-metrics
  • #1117 chore: rename meaure to value recorder (@dyladan)
• opentelemetry-api, opentelemetry-core, opentelemetry-tracing
  • #1058 feat: spec compliant sampling result support (@legendecas)

:rocket: (Enhancement)

• Other
  • #1181 feat: add node-plugins-all package (@dyladan)
• opentelemetry-plugin-fetch, opentelemetry-plugin-xml-http-request, opentelemetry-web
  • #1121 chore: adding plugin-fetch and example (@obecny)
• opentelemetry-node
  • #1153 feat: add OPENTELEMETRY_NO_PATCH_MODULES (@markwolff)
  • #1151 chore(todo): add missing span sampling test (@markwolff)
• opentelemetry-exporter-jaeger
  • #965 feat(opentelemetry-exporter-jaeger): http sender (@leonardodalcin)
• opentelemetry-exporter-zipkin
  • #1138 feat(opentelemetry-js): infer zipkin service name from resource (@rezakrimi)
• opentelemetry-plugin-xml-http-request
  • #1133 fix(plugin-xml-http-request): support sync requests (@johnbley)
• opentelemetry-metrics
  • #1145 chore: creating new metric kind (@obecny)
• opentelemetry-exporter-collector
  • #1204 feat: collector exporter custom headers and metadata (@mwear)
• opentelemetry-exporter-zipkin
  • #1202 Adds possibility to set headers to zipkin exporter (@obecny)

:bug: (Bug Fix)

• opentelemetry-exporter-collector
  • #1197 fix(exporter-collector): default endpoint for node and browser (@davidwitten)
• opentelemetry-context-zone-peer-dep
  • #1209 chore: fixing zone from which to fork a new zone (@obecny)

:sparkles: (Feature)

• opentelemetry-semantic-conventions
  • #1160 refactor(attributes): move enums to @opentelemetry/semantic-conventions (@markwolff)

:books: (Refine Doc)

• Other
  • #1192 Fix_typo (@shivkanya9146)
  • #1147 ci: lint markdown files (@naseemkullah)
  • #1142 chore: template prometheus endpoint in examples rather than hardcode (@naseemkullah)
  • #1217 chore: fix markdown linting and add npm script (@dyladan)

Committers: 13

• David W. (@davidwitten)
• Bartlomiej Obecny (@obecny)
• Daniel Dyla (@dyladan)
• Mark Wolff (@markwolff)
• Mayur Kale (@mayurkale22)
• Naseem (@naseemkullah)
• Valentin Marchaud (@vmarchaud)
• legendecas (@legendecas)
• Shivkanya Andhare (@shivkanya9146)
• Leonardo Dalcin (@leonardodalcin)
• @rezakrimi
• John Bley (@johnbley)
• Matthew Wear (@mwear)