# Linux+Java Application Tracing

<mark style="background-color:purple;">This guide is based on a Java application packaged with Maven.</mark>\ <mark style="background-color:purple;">Please reference Otels documentation for different setups -</mark> [![](https://opentelemetry.io/favicons/favicon-16x16.png)<mark style="background-color:purple;">Java zero-code instrumentation</mark>](https://opentelemetry.io/docs/zero-code/java/)

### Install the collector <a href="#install-the-collector" id="install-the-collector"></a>

At the time of writing, the latest version of the OpenTelemetry Collector is 0.117.0

1. Find the latest version of the OpenTelemetry collectors [here](https://github.com/open-telemetry/opentelemetry-collector-releases/releases/). In this guide we will install `otelcol-contrib_0.117.0_linux_amd64`
2. Download and install
   1. **Deb-based**
      1. `sudo apt-get update`
      2. `sudo apt-get -y install wget`
      3. `wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.117.0/otelcol-contrib_0.117.0_linux_amd64.deb`
      4. `sudo dpkg -i otelcol-contrib_0.117.0_linux_amd64.deb`
   2. **RHEL-based**
      1. `sudo dnf update -y`
      2. `sudo dnf install -y wget`
      3. `wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.117.0/otelcol-contrib_0.117.0_linux_amd64.rpm`
      4. `sudo rpm -ivh otelcol-contrib_0.117.0_linux_amd64.rpm`
3. Navigate to `/etc/otelcol-contrib/`
4. Edit the config file with your favourite file editor, for example: `nano config.yaml`
5. Paste the following into the config file overwriting it completely:

   `receivers: otlp: protocols: grpc: endpoint: localhost:4317 http: endpoint: localhost:4318 processors: batch: exporters: otlphttp: traces_endpoint: https://<your_domain>/v1/json_batch/otlptraces encoding: json compression: gzip headers: Authorization: "Bearer <your_token>" tls: insecure: false insecure_skip_verify: true service: pipelines: traces: receivers: [otlp] processors: [batch] exporters: [otlphttp]`

   1. Replace \<your\_domain> with the domain of your Ascent environment e.g [company.apica.io](http://company.apica.io/)
   2. Replace \<your\_token> with your ingest token ([How to get your ingest token](https://docs.apica.io/integrations/overview/generating-a-secure-ingest-token))
6. When you’ve finished editing the config, save it and run `otelcol-contrib validate --config=config.yaml`
   1. If you get no error returned, the config file is valid.
7. Restart the service with `sudo systemctl restart otelcol-contrib`
8. Verify that the service is up and running correctly with `sudo systemctl status otelcol-contrib`

### Install and configure the Java agent <a href="#install-and-configure-the-java-agent" id="install-and-configure-the-java-agent"></a>

At the time of writing, the latest version of the Java agent is [2.11.0](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v2.11.0)

1. Download the agent jar - [opentelemetry-javaagent.jar](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/download/v2.11.0/opentelemetry-javaagent.jar)
   1. `wget https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/download/v2.11.0/opentelemetry-javaagent.jar`
2. **Run Your Application with the Agent**: Add the agent as a JVM option when starting your application:

   `java -javaagent:/path/to/opentelemetry-javaagent.jar \ -Dotel.exporter.otlp.endpoint=http://localhost:4317 \ -Dotel.exporter.otlp.protocol=grpc \ -Dotel.traces.exporter=otlp \ -Dotel.metrics.exporter=none \ -Dotel.service.name=your-java-app \ -Dotel.resource.attributes=environment=production \ -jar your-app.jar`

<mark style="background-color:green;">Depending on the amount of traces generated, you can pretty quickly verify that traces is passing through to Ascent by navigating to</mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">**Explore**</mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">></mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">**Distributed**</mark> <mark style="background-color:green;">**Tracing**</mark> <mark style="background-color:green;"></mark><mark style="background-color:green;">and in the dropdown Service you will after a short while see your application appear.</mark>

<mark style="background-color:green;">In this case, the service name “your-java-app” would show up as a Service.</mark>

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apica.io/observe/overview/linux+java-application-tracing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.