API/Code
Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud. Availability This functionality is generally available and ready for production usage. The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability This functionality is generally available and ready for production usage. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes. The Elastic APM Java agent enables you to trace the execution of operations in your Java applications, sending performance metrics and errors to the Elastic APM Server. Availability This functionality is generally available and ready for production usage. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.
Serverless Observability
Generally available
Stack
Generally available
APM Agent Java
Generally available
Use the span API to manually create spans for methods of interest. The API is extremely flexible, and offers the ability to customize your spans, by adding labels to them, or by changing the type, name, or timestamp.
OpenTracing fan? You can use the OpenTracing API, instead of the Agent API, to manually create spans.
- Get the current span with
currentSpan(), which may or may not have been created with auto-instrumentation. - Create a child span with
startSpan(). - Activate the span with
activate(). - Customize the span with the span API.
import co.elastic.apm.api.ElasticApm;
import co.elastic.apm.api.Span;
Span parent = ElasticApm.currentSpan();
Span span = parent.startSpan();
try (Scope scope = span.activate()) {
span.setName("SELECT FROM customer");
span.addLabel("foo", "bar");
// do your thing...
} catch (Exception e) {
span.captureException(e);
throw e;
} finally {
span.end();
}
- Get current span
- Create a child span
- Make this span the active span on the current thread
- Override the default span name
- Add labels to the span
You can combine annotations with the span API to increase their flexibility. Just get the current span on an annotated method and customize the span to your liking.
@CaptureSpan
private static void spanWithAnnotation(String foo) {
Span span = ElasticApm.currentSpan();
span.setTag("foo", foo);
}
- Use
@CaptureSpanannotation to create a span - Get the current span (the one created via the
@CaptureSpanannotation) - Customize the span