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.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.Builder of
BetterStackLogClientOptions.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.Options of a
BetterStackOtlpLogExporter.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.What
BatchProcessor.add(codes.grow.packages.betterstack.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.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.
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.Wire protocol of a
BetterStackClient.logClient(BetterStackLogClientOptions).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.Options of
BetterStackQuery.searchLogs(SearchLogsOptions).Builder of
SearchLogsOptions.Options of
LogQueryClient.search(java.lang.String, codes.grow.packages.betterstack.logging.SearchOptions): time range, limit (default 100), order, cursor.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).