All Classes and Interfaces

Class
Description
Normalises attribute values (AttrValue) into the kinds the SDK accepts.
Missing or invalid credentials (HTTP 401).
LogClient built from a LogExporter, BatchOptions, resource attributes and a RedactionProcessor.
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.
Client for Better Stack Logs: ingestion through the source's ingesting host (BetterStackClient.logClient(), BetterStackClient.exporter(), BetterStackClient.otlpExporter()) and the SQL query API (BetterStackClient.query()), each with its own credentials and transport.
Builder that configures and creates a client in one chain.
Immutable configuration of a BetterStackClient (SPEC section 2.2).
Builder of the configuration.
Better Stack specific error mapping on top of the SPEC section 2.1 HTTP mapping.
Maps LogRecords to Better Stack events and encodes request bodies (JSON, NDJSON, MessagePack).
Base class of every error raised by the Better Stack Logs SDK (SPEC section 2.1).
Options of BetterStackClient.logClient(BetterStackLogClientOptions): protocol, exporter options, batching, resource and redaction.
LogExporter for Better Stack's HTTP ingest API (POST {url}/ on the source's ingesting host, Authorization: Bearer <source token>).
Options of a BetterStackLogExporter: body encoding and request limits.
LogExporter that sends OTLP/HTTP logs to the source's ingesting host (POST {url}/v1/logs, Authorization: Bearer <source token>), protobuf by default or OTLP/JSON.
SQL query client for Better Stack Logs: the ClickHouse HTTP interface of the query host with the connection's own Basic credentials.
The caller cancelled the operation (future cancelled, thread interrupted, client closed).
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.
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.
Body encodings accepted by POST / on a Better Stack source's ingesting host.
LogExporter that keeps every accepted record in memory.
LogQueryClient over in-memory records (usually InMemoryLogExporter.records()).
Shared Jackson configuration of the SDK.
JUnit 5 adapter: one dynamic test per scenario.
Sends log records to the service in the background.
Something a LogClient accepts: a complete LogRecord or a short LogInput.
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).
Minimal MessagePack encoder for Better Stack ingest bodies (no dependency).
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.
OTLP logs encoding without dependencies: ExportLogsServiceRequest as protobuf (field numbers of opentelemetry-proto collector/logs/v1 and logs/v1) or as OTLP/JSON, and partial_success parsing of the response.
Partial success reported by an OTLP response.
Payload format of BetterStackOtlpLogExporter.
The credentials lack a permission (HTTP 403).
Generic polling helper (pollUntil): used by waitForLog, waitForTrace and service waiters.
Better Stack answered 402 Quota exceeded: the team's quota or spending limit is reached.
The service rate-limited the call (HTTP 429); see BetterStackException.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.
Retry settings with full-jitter exponential backoff (SPEC section 2.3).
Builder for RetryPolicy.
A parsed conformance scenario (conformance/scenarios/*.json).
One step of a scenario.
Package identity used in the User-Agent header.
Builder of SearchLogsOptions.
Builder for SearchOptions.
A credential held in a char[] that never prints itself.
The service answered with a body the SDK cannot use: an invalid JSON response or a ClickHouse exception without a specific mapping that followed a 200 answer.
Log severity with the OpenTelemetry severity numbers.
Everything an OpHandler needs for one step.
Creates the object a scenario runs against (client, provider, log client, tracing handle).
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.
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).