All Classes and Interfaces
Class
Description
Normalises attribute values (
AttrValue) into the kinds the SDK accepts.Missing or invalid credentials (HTTP 401).
Builder for
BatchingLogClient.Options of a
BatchProcessor.Builder for
BatchOptions.Queues log records and exports them in batches from one background thread (a single-threaded
ScheduledExecutorService).Counters of a
BatchProcessor.The caller cancelled the operation (future cancelled, thread interrupted, client closed).
Health of an OpenTelemetry Collector:
GET {healthUrl} (health_check extension,
port 13133) and, when that endpoint is unreachable (stock Grow stacks bind it to localhost),
GET {zpagesUrl}/debug/servicez (port 55679).LogQueryClient of the collector: the collector stores nothing and has no query API, so
every method throws UnsupportedException.TraceQueryClient of the collector: the collector stores nothing and has no query API, so
every method throws UnsupportedException.Invalid or missing configuration.
Conflicting write or check-and-set mismatch (HTTP 409, 412).
The operations of one scenario category (
core, secrets, logging,
tracing) for the ConformanceRunner.Results of a conformance run.
Result of one scenario.
Outcome of a scenario or step.
Result of one step.
Runs the shared conformance scenarios (
conformance/scenarios/*.json, SPEC section 6)
against targets supplied by a service's integration test.Builder for
ConformanceRunner.Conformance operations of the
core category: health, ping,
serverVersion, close.A target of the
core conformance category that is not the service client: a fake for unit
tests of the runner, or an adapter for a client whose core methods differ.A service dependency edge.
What
BatchProcessor.add(codes.grow.packages.otelcollector.logging.LogRecord) does when the queue is full.Why records were dropped (argument of
BatchOptions.Builder.onDrop).Reads configuration from environment variables (SPEC section 2.2).
Canonical error codes shared by every Grow Codes SDK (SPEC section 2.1).
Service hook that replaces the error
HttpTransport derived from a failed response, for
vendor-specific mapping (for example a 403 that means bad credentials, or a 500 whose body says
the request will never succeed).Evaluates the
expect object of a scenario step (SPEC section 6).java.util.logging handler that forwards records to a LogClient.Log4j 2 appender plugin (
<GrowLog name="grow"/>) that forwards events to a LogClient (Log4j is an optional, provided dependency).Logback appender that forwards events to a
LogClient (Logback is an optional,
provided dependency).Implements the
health() contract (SPEC section 2.4): never throws for an unhealthy or
unreachable service, only for CancelledException and ConfigException.Result of
health() (SPEC section 2.4).Callbacks invoked for every HTTP attempt (SPEC section 2.5).
The HTTP engine shared by every client of the SDK (SPEC section 2.3), built on
HttpClient.LogExporter that keeps every accepted record in memory.LogQueryClient over in-memory records (usually InMemoryLogExporter.records()).SpanExporter that keeps finished spans in memory.TraceQueryClient over in-memory spans (usually InMemorySpanExporter.spans()),
including a dependency graph computed from parent/child spans of different services.Options of the metric instrument helpers (
counter, upDownCounter,
histogram, gauge).Shared Jackson configuration of the SDK.
JUnit 5 adapter: one dynamic test per scenario.
Sends log records to the service in the background.
Sends batches of log records to the service.
Minimal logger used by the transport (SPEC section 2.5).
Small logging facade on top of a
LogClient.Conformance operations of the
logging category: send, sendBatch,
flush, searchUntil, stats.Target of the
logging conformance scenarios: the client that sends and the (optional)
query client that reads back.Short form of a log record: a message plus optional severity, attributes, timestamp and trace
ids.
Builder for
LogInput.Reads logs back from the service.
One immutable log record in the normalized SDK form (OpenTelemetry log data model).
Builder for
LogRecord.Converts
LogRecord to and from the normalized JSON wire form (
spec/schemas/log-record.schema.json).The record does not exist (HTTP 404).
Executes one scenario step and returns its result (or an
OpResult).A step result with optional extra views for the expectations
count and tree.Converts SDK attribute values (
AttrValue: String, numbers, Boolean, lists, maps) into
OpenTelemetry Attributes.Client for an OpenTelemetry Collector: health (
health_check with zpages fallback), an
authenticated OTLP ping, the collector version, and factories for the telemetry
bootstrap, tracing, log clients and exporters whose lifetime the client owns (OtelCollectorClient.close()
flushes and shuts them down).Builder that configures and creates a client in one chain.
Immutable configuration of a
OtelCollectorClient and of every OTLP exporter this package
builds (traces, logs, metrics).Builder of the configuration.
Base class of every error raised by the OpenTelemetry Collector SDK (SPEC section 2.1).
OTLP log clients for the collector: a
BatchingLogClient (SPEC section 4) over OtlpLogExporter, with the service resource (service.name, version, environment and the
configured resource attributes) and the configured log batch settings (OTEL_BLRP_*).OTLP metrics for the collector: the official OTLP metric exporter (cumulative temporality) and
meter / counter / upDownCounter / histogram / gauge
helpers on the global MeterProvider (registered by initTelemetry unless
setGlobal(false)).One-call OpenTelemetry bootstrap for every Grow stack (the platform deploys the collector with
each stack): traces (
OtelCollectorTracing), logs (an OpenTelemetry LoggerProvider
for log appenders plus a BatchingLogClient) and metrics (MeterProvider with a
periodic reader) with one shared resource and the official OTLP exporters.Tracing preset for the OpenTelemetry Collector (SPEC section 5): the official OTLP span exporters
(
http/protobuf to http://127.0.0.1:4318/v1/traces by default, or grpc to
http://127.0.0.1:4317) and initTracing with collector defaults from the
environment.Converts SDK attribute maps (strings, booleans, longs, doubles, lists and nested maps) to
OpenTelemetry
Attributes: homogeneous primitive lists become array attributes, nested
maps and mixed lists become AnyValue (AttributeKey.valueKey(java.lang.String)) attributes.Shared OTLP plumbing: gRPC method paths, decoding of
google.rpc.Status and partial
success bodies, mapping of HTTP and gRPC statuses to the SDK exceptions, and exporter settings
(retry policy, TLS) for the official OpenTelemetry exporters.A decoded OTLP partial success.
A decoded
google.rpc.Status.OTLP span exporters (gRPC and HTTP/protobuf) configured from a
TracingConfig: endpoint,
headers, compression, export timeout and TLS.LogExporter (SPEC section 4) that sends records to the collector over OTLP with the
official OpenTelemetry log exporter: POST {logsUrl} (application/x-protobuf) or
gRPC LogsService/Export.The credentials lack a permission (HTTP 403).
Generic polling helper (
pollUntil): used by waitForLog, waitForTrace and
service waiters.The service rate-limited the call (HTTP 429); see
OtelCollectorException.retryAfter().Redaction helpers for headers, URLs, structured fields and free text (SPEC section 2.6).
Redacts log records before they are queued.
Builder for
RedactionProcessor.Best-effort client-side resource detection:
host (host.name, host.arch,
os.type, os.version), process (process.pid,
process.executable.path, process.runtime.*, process.owner), container
(container.id from cgroups) and k8s (k8s.pod.name,
k8s.namespace.name, … from the downward-API variables K8S_* / POD_*,
HOSTNAME and the service-account namespace file).Retry settings with full-jitter exponential backoff (SPEC section 2.3).
Builder for
RetryPolicy.JVM runtime metrics (semantic-convention names) observed on every collection:
jvm.memory.used and jvm.memory.committed (By, jvm.memory.type heap / non_heap),
jvm.thread.count, jvm.class.count, jvm.cpu.time (s),
jvm.cpu.recent_utilization and process.uptime (s).A parsed conformance scenario (
conformance/scenarios/*.json).One step of a scenario.
Package identity used in the
User-Agent header.Options of
LogQueryClient.search(java.lang.String, codes.grow.packages.otelcollector.logging.SearchOptions): time range, limit (default 100), order, cursor.Builder for
SearchOptions.A credential held in a
char[] that never prints itself.Log severity with the OpenTelemetry severity numbers.
The three OpenTelemetry signals the collector receives.
A span as returned by a
TraceQueryClient (normalized model; not the OpenTelemetry API
span).Span event.
Span kind (wire values are lower case).
Span link.
Span status.
Status code (wire values are lower case).
Converts OpenTelemetry SDK
SpanData into the normalized query Span.Creates the span exporter for a
TracingConfig (see OtlpExporters.factory()).A span with its children (see
Traces.buildTree(java.util.List<codes.grow.packages.otelcollector.tracing.query.Span>)).Options of
Spans.withSpan(java.lang.String, codes.grow.packages.otelcollector.tracing.ThrowingSupplier<T, E>): attributes, kind, links, tracer, parent context.Builder for
SpanOptions.Span helpers on top of the OpenTelemetry API.
Everything an
OpHandler needs for one step.Creates the object a scenario runs against (client, provider, log client, tracing handle).
A running telemetry setup (all three signals) created by
OtelCollectorTelemetry.initTelemetry().Options of
OtelCollectorTelemetry.initTelemetry(OtelCollectorConfig, TelemetryOptions):
per-signal switches over the config, global registration, metric settings and exporter
replacements (tests).Builder of
TelemetryOptions.A runnable that may throw.
A supplier that may throw.
A connect, request or total deadline was exceeded (or HTTP 408, 504).
TLS settings: custom CA, client certificate (mutual TLS) and the test-only
insecureSkipVerify.Builder for
TlsOptions.A trace: its id and its spans sorted by start time, then span id.
Tracing of plain functions:
Traced.run(String, Callable) and the Traced.Method
annotation honoured by TracedProxy.Marks an interface method (or its implementation) to run in a span when called through a
TracedProxy.Wraps a
HttpClient: every request runs in a client span and carries the propagation
headers.Proxy-based interceptor that runs methods annotated with Traced.Method (on the
interface or on the implementation) in a span.Trace and span id normalisation (lower-case hex; 64-bit trace ids are left-padded to 32).
Reads traces back from the service.
Span ordering and tree helpers.
Filter of
TraceQueryClient.searchTraces(codes.grow.packages.otelcollector.tracing.query.TraceSearchQuery) (limit defaults to 20).Builder for
TraceSearchQuery.Search result entry.
Sets up the OpenTelemetry SDK from a
TracingConfig.Span batch processor settings.
Builder for
TracingConfig.Export body compression.
Export protocol.
Sampler (OpenTelemetry
OTEL_TRACES_SAMPLER names).Jakarta Servlet filter that continues the caller's trace (W3C/B3 headers per the configured
propagators) and records one server span per request (Servlet API is a
provided
dependency).Running tracing setup returned by
Tracing.initWith(codes.grow.packages.otelcollector.tracing.TracingConfig, codes.grow.packages.otelcollector.tracing.SpanExporterFactory).OkHttp interceptor (OkHttp is an optional dependency) that runs each call in a client span and
adds the propagation headers.
Conformance operations of the
tracing category: span, flush,
getTraceUntil, listServices.Target of the
tracing conformance scenarios.Settings of one
HttpTransport.Builder for
TransportConfig.One logical HTTP call executed by
HttpTransport (with retries).Builder for
TransportRequest.A response returned by
HttpTransport (2xx or an accepted status).Network error or HTTP 500, 502, 503.
The service or deployment does not offer this capability (HTTP 501).
The request or a value is invalid (HTTP 400, 413, 422, other 4xx).