Package codes.grow.packages.datadogapm
package codes.grow.packages.datadogapm
Grow Codes SDK for Datadog APM.
Start with DatadogApmClient.fromEnv().
Shared building blocks live in core (errors, transport, redaction); category APIs in
secrets, logging and tracing; in-memory fakes and the conformance runner
in testing.
-
ClassDescriptionThe Datadog Agent's
GET /infodocument (fields this package reads).The Datadog APM client (API.md section 1).Builder that configures and creates a client in one chain.Immutable configuration of aDatadogApmClient,DatadogTracing.initTracing()andDatadogSpansQuery(SPEC section 2.2, API.md section 0, DECISIONS.md #1).Builder of the configuration.Datadog <-> OpenTelemetry id conversion (API.md section 3, DECISIONS.md #3).A trace id split the way Datadog stores it.Datadog log correlation (DECISIONS.md #3).Datadog span formats to the SPEC section 5 trace model (API.md sections 2.1 and 4).Datadog header propagation (x-datadog-*) with ddtrace's conflict rules (API.md section 3, DECISIONS.md #5).A W3C context that lost against Datadog headers inDatadogPropagator.extract(io.opentelemetry.context.Context, C, io.opentelemetry.context.propagation.TextMapGetter<C>).A warning attached to a partial or adjusted Datadog query result (meta.warnings[]).Datadog sites and the query API base URL (API.md section 0).One span returned by the spans search API.Datadog error attributes (DECISIONS.md #2).Span exporter wrapper installed byDatadogTracing.initTracing().The Datadog spans query client: the SaaS API athttps://api.<site>with the headersDD-API-KEYandDD-APPLICATION-KEY(the application key needsapm_read).A point in time for a Datadog query: an absolute instant (sent as ISO-8601 in UTC with milliseconds) or a Datadog date expression (now-15m, ISO-8601, epoch milliseconds) sent as is.initTracingfor Datadog: the OpenTelemetry SDK exporting OTLP to the Datadog Agent (HTTP/protobuf on 4318 by default, or gRPC on 4317), unified service tagging, the Datadog + W3C propagators, the Datadog error attributes and the terminated-context links (API.md section 2, DECISIONS.md #2, #5).A running Datadog tracing setup returned byDatadogTracing.initTracing().Builder ofSearchSpansOptions.One bucket of an aggregation.Buckets of a numeric facet.Order of the groups.