Package codes.grow.packages.cloudwatchlogs
package codes.grow.packages.cloudwatchlogs
Grow Codes SDK for Amazon CloudWatch Logs.
Start with CloudWatchLogsClient.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.
-
ClassDescriptionMaps AWS SDK errors to the SPEC section 2.1 exception classes (API.md section 1.1): AWS error code first, then the HTTP status, then network, timeout and cancellation shapes.Redacted copy of an AWS SDK exception kept as the cause of a mapped exception: class name and AWS error code, the message with known secrets removed, and the original stack trace.Options of
CloudWatchLogsClient.logClient.Client for Amazon CloudWatch Logs, built on the official AWS SDK for Java v2 (SPEC section 2.3 "Cloud SDK services").Builder that configures and creates a client in one chain.Immutable configuration of aCloudWatchLogsClient(SPEC section 2.2, API.md section 5).Builder of the configuration.Exports log records withPutLogEventsto one group/stream (SPEC section 4LogExporter, API.md section 3).LogQueryClientover one log group (SPEC section 4, DECISIONS 2).Options ofdescribeLogGroups.Builder ofDescribeLogGroupsOptions.Options ofdescribeLogStreams.Builder ofDescribeLogStreamsOptions.Options ofdescribeQueries.Builder ofDescribeQueriesOptions.CloudWatch Embedded Metric Format (EMF) documents (API.md section 2.2).Options ofEmf.build(java.lang.String, double, java.util.Map<java.lang.String, java.lang.String>, codes.grow.packages.cloudwatchlogs.Emf.Options)andCloudWatchLogsClient.emf.Options ofensureLogGroup.Builder ofEnsureLogGroupOptions.Result ofensureLogGroup.Result ofensureLogStream.One event returned byfilterLogEvents.Options offilterLogEvents.Builder ofFilterLogEventsOptions.OneFilterLogEventspage.Options ofgetLogEvents.Builder ofGetLogEventsOptions.One live-tail event.Handle of a live-tail session (startLiveTail).Callbacks ofstartLiveTail.Builder ofLiveTailOptions.WhatstartLiveTailtails.Builder ofLiveTailRequest.Metadata of one live-tailsessionUpdateframe (also empty keep-alive updates).One log event to send withputLogEvents.Client-side PutLogEvents batching (DECISIONS 5, API.md section 2.2).An event as sent to AWS.A log group (DescribeLogGroups).A log stream (DescribeLogStreams).Sort key ofdescribeLogStreams.What happens to a log event whose message is larger thanmaxEventBytes.Options ofputLogEvents.Builder ofPutLogEventsOptions.Result ofputLogEvents.One Logs Insights query (describeQueries).Options ofstartQueryandquery(Logs Insights).Builder ofQueryOptions.Result ofgetQueryResults/query.Logs Insights scan statistics (reported by AWS only).Logs Insights query status.Events of one batch that the service did not store (indexes into the sorted batch).One event returned bygetLogEvents.