{"id":21432164,"url":"https://github.com/signalfx/splunk-otel-java","last_synced_at":"2026-04-22T19:01:26.425Z","repository":{"id":37085093,"uuid":"283528421","full_name":"signalfx/splunk-otel-java","owner":"signalfx","description":"Splunk Distribution of OpenTelemetry Java","archived":false,"fork":false,"pushed_at":"2026-04-17T08:08:15.000Z","size":5568,"stargazers_count":73,"open_issues_count":9,"forks_count":45,"subscribers_count":13,"default_branch":"main","last_synced_at":"2026-04-17T10:16:41.040Z","etag":null,"topics":["instrumentation","java","java-agent","jvm","metrics","opentelemetry","tracing"],"latest_commit_sha":null,"homepage":"https://docs.splunk.com/Observability/gdi/get-data-in/application/java/get-started.html","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/signalfx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-07-29T14:58:00.000Z","updated_at":"2026-04-17T08:08:19.000Z","dependencies_parsed_at":"2023-09-29T19:17:30.808Z","dependency_job_id":"4fec6271-fd20-401e-afbc-31d67bcc48b7","html_url":"https://github.com/signalfx/splunk-otel-java","commit_stats":null,"previous_names":[],"tags_count":111,"template":false,"template_full_name":null,"purl":"pkg:github/signalfx/splunk-otel-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/signalfx%2Fsplunk-otel-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/signalfx%2Fsplunk-otel-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/signalfx%2Fsplunk-otel-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/signalfx%2Fsplunk-otel-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/signalfx","download_url":"https://codeload.github.com/signalfx/splunk-otel-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/signalfx%2Fsplunk-otel-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32150397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["instrumentation","java","java-agent","jvm","metrics","opentelemetry","tracing"],"created_at":"2024-11-22T23:16:55.492Z","updated_at":"2026-04-22T19:01:26.394Z","avatar_url":"https://github.com/signalfx.png","language":"Java","readme":"# Splunk Distribution of OpenTelemetry Java\n\n![Stable](https://img.shields.io/badge/status-stable-informational)\n[![OpenTelemetry Instrumentation for Java Version](https://img.shields.io/badge/otel-2.27.0-blueviolet)](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.27.0)\n[![Splunk GDI specification](https://img.shields.io/badge/GDI-1.9.0-blueviolet)](https://github.com/signalfx/gdi-specification/releases/tag/v1.9.0)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/signalfx/splunk-otel-java?include_prereleases)](https://github.com/signalfx/splunk-otel-java/releases)\n[![Maven Central](https://img.shields.io/maven-central/v/com.splunk/splunk-otel-javaagent)](https://central.sonatype.com/artifact/com.splunk/splunk-otel-javaagent)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/signalfx/splunk-otel-java/ci.yaml?branch=main)](https://github.com/signalfx/splunk-otel-java/actions/workflows/ci.yaml)\n\n* [Get Started](#get-started)\n* [Get Involved](CONTRIBUTING.md)\n* [Migrate from SignalFx Java Agent](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/migrate-from-signalfx-java-agent)\n* [About the distribution](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/about-splunk-otel-java)\n* [Security](SECURITY.md)\n* [Supported Libraries](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/requirements#supported-libraries-and-frameworks-0)\n* [Troubleshooting](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/troubleshoot-the-java-agent)\n\nThe Splunk Distribution of [OpenTelemetry Instrumentation for\nJava](https://github.com/open-telemetry/opentelemetry-java-instrumentation)\nprovides a Java Virtual Machine (JVM)\nagent that automatically instruments your Java application to capture and report\ndistributed traces to [Splunk APM](https://help.splunk.com/en/splunk-observability-cloud/monitor-application-performance/introduction-to-splunk-apm).\n\nThis distribution comes with the following defaults:\n\n- [W3C `tracecontext`](https://www.w3.org/TR/trace-context/) and [W3C\n  baggage](https://www.w3.org/TR/baggage/) context propagation;\n  [B3](https://github.com/openzipkin/b3-propagation) can also be\n  [configured](https://github.com/signalfx/splunk-otel-java/blob/main/docs/advanced-config.md#trace-propagation-configuration).\n- [OTLP HTTP/protobuf\n  exporter](https://opentelemetry.io/docs/specs/otlp/#otlphttp)\n  configured to send spans to a locally running [Splunk OpenTelemetry\n  Collector](https://github.com/signalfx/splunk-otel-collector)\n- Unlimited default limits for [configuration\n  options](docs/advanced-config.md#trace-configuration) to support\n  full-fidelity traces.\n\nIf you're currently using the SignalFx Java Agent and want to\nmigrate to the Splunk Distribution of OpenTelemetry Java,\nsee [Migrate from the SignalFx Java Agent](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/migrate-from-signalfx-java-agent).\n\n---\n\n\u003c!-- Comments, spacing, empty and new lines in the section below are intentional, please do not modify them! --\u003e\n\u003c!--DEV_DOCS_WARNING--\u003e\n\u003c!--DEV_DOCS_WARNING_START--\u003e\nThe following documentation refers to the in-development version of `splunk-otel-java`. Docs for the latest version ([v2.27.0](https://github.com/signalfx/splunk-otel-java/releases/latest)) can be found [here](https://github.com/signalfx/splunk-otel-java/blob/v2.27.0/README.md).\n\n---\n\u003c!--DEV_DOCS_WARNING_END--\u003e\n\n## Requirements\n\nThe agent works with Java runtimes version 8 and higher. For the full list of requirements and supported libraries and versions, see [Requirements for the Java agent](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/requirements) in the official Splunk documentation.\n\n## Get started\n\nFor complete instructions on how to get started with the Splunk Distribution of OpenTelemetry Java, see [Instrument Java services for Observability Cloud](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application) in the official Splunk documentation.\n\nTo see the Java Agent in action with sample applications, see the OpenTelemetry\n[examples](https://github.com/open-telemetry/opentelemetry-java-examples/tree/main/javaagent).\n\n## Advanced configuration\n\nTo fully configure the agent of the Splunk Distribution of OpenTelemetry Java, see [Configure the Java agent](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/configure-the-java-agent) in the official Splunk documentation.\n\n## Correlating traces with logs\n\nThe Splunk Distribution of OpenTelemetry Java provides a way to correlate traces with logs. For more information see [Connect Java application trace data with logs](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/connect-trace-data-with-logs) \nin the Splunk Observability Cloud user documentation.\n\n## Manually instrument a Java application\n\nDocumentation on how to manually instrument a Java application is available in the \n[OpenTelemetry official documentation](https://opentelemetry.io/docs/instrumentation/java/manual/).\nTo learn how to add custom metrics to your application see [Manual instrumentation](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/manual-instrumentation#send-custom-java-application-metrics-0).\n\nTo extend the instrumentation with the OpenTelemetry Instrumentation for Java,\nyou have to use a compatible API version.\n\n\u003c!-- IMPORTANT: do not change comments or break those lines below --\u003e\nThe Splunk Distribution of OpenTelemetry Java version \u003c!--SPLUNK_VERSION--\u003e2.27.0\u003c!--SPLUNK_VERSION--\u003e is compatible\nwith:\n\n* OpenTelemetry API version \u003c!--OTEL_VERSION--\u003e1.61.0\u003c!--OTEL_VERSION--\u003e\n* OpenTelemetry Instrumentation for Java version \u003c!--OTEL_INSTRUMENTATION_VERSION--\u003e2.27.0\u003c!--OTEL_INSTRUMENTATION_VERSION--\u003e\n\n## Snapshot builds\n\nWe publish [snapshot builds](https://central.sonatype.com/service/rest/repository/browse/maven-snapshots/com/splunk/splunk-otel-javaagent/2.28.0-SNAPSHOT/)\nwith every merge to the `main` branch. Snapshots are primarily intended to test new functionality and are not recommended\nfor production use.\n\n## Upgrades\n\nFor information and best practices around upgrades, see the [Upgrading documentation](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/instrument-your-java-application#upgrade-the-splunk-distribution-of-opentelemetry-java-0).\n\n## Troubleshooting\n\nFor troubleshooting information and known issues, see [Troubleshooting Java instrumentation](https://help.splunk.com/en/splunk-observability-cloud/manage-data/available-data-sources/supported-integrations-in-splunk-observability-cloud/apm-instrumentation/instrument-a-java-application/troubleshoot-the-java-agent) \nin the Splunk Observability Cloud user documentation.\n\n# License\n\nThe Splunk Distribution of OpenTelemetry Java is a distribution of [OpenTelemetry Instrumentation for Java](https://github.com/open-telemetry/opentelemetry-java-instrumentation). It is licensed under the terms of the Apache Software License version 2.0. For more details, see [the license file](./LICENSE).\n\n\u003eℹ️\u0026nbsp;\u0026nbsp;SignalFx was acquired by Splunk in October 2019. See [Splunk SignalFx](https://www.splunk.com/en_us/about-splunk/acquisitions/signalfx.html) for more information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsignalfx%2Fsplunk-otel-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsignalfx%2Fsplunk-otel-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsignalfx%2Fsplunk-otel-java/lists"}