Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 964b21f

Browse files
committedFeb 16, 2025·
readme added
1 parent 58cb91c commit 964b21f

File tree

1 file changed

+46
-13
lines changed

1 file changed

+46
-13
lines changed
 

‎README.md

+46-13
Original file line numberDiff line numberDiff line change
@@ -72,19 +72,52 @@ java -javaagent:path/to/opentelemetry-javaagent.jar \
7272

7373
## Configuring the Agent
7474

75-
The agent is highly configurable! Many aspects of the agent's behavior can be
76-
configured for your needs, such as exporter choice, exporter config (like where
77-
data is sent), trace context propagation headers, and much more.
78-
79-
For a detailed list of agent configuration options, see the [agent configuration docs][config-agent].
80-
81-
For a detailed list of additional SDK configuration environment variables and system properties,
82-
see the [SDK configuration docs][config-sdk].
83-
84-
*Note: Config parameter names are very likely to change over time, so please check
85-
back here when trying out a new version!
86-
Please [report any bugs](https://github.com/open-telemetry/opentelemetry-java-instrumentation/issues)
87-
or unexpected behavior you find.*
75+
### 2️⃣ **Configuration Parameters**
76+
77+
| Parameter | Description |
78+
|--------------------------------------------------------------------------------------------------|-------------------------------------------------------------|
79+
| `-Dotel.metrics.exporter=none` | Disables metric collection. |
80+
| `-Dotel.logs.exporter=none` | Disables log collection. |
81+
| `-Dotel.exporter.otlp.traces.endpoint="{host}}/v1/apiwiz-runtime-agent/api-visualiser/otel/traces"` | Specifies the OTLP (OpenTelemetry Protocol) endpoint for trace data. |
82+
| `-Dotel.exporter.otlp.traces.headers="x-tenant={workspaceName},apikey={apikey}"` | Adds authentication headers for the OTLP trace exporter. |
83+
| `-Dotel.exporter.otlp.traces.timeout=600000` | Sets the trace export timeout (600,000 ms = 10 minutes). |
84+
| `-Dapi.compliance.tracing.traceId=traceid` | Defines the trace ID key for API compliance tracing. |
85+
| `-Dapi.compliance.tracing.spanId=spanid` | Defines the span ID key for API compliance tracing. |
86+
| `-Dapi.compliance.tracing.parentSpanId=parentspanid` | Defines the parent span ID key. |
87+
| `-Dapi.compliance.tracing.requestTimeStamp=request-timestamp` | Defines the request timestamp key. |
88+
| `-Dapi.compliance.tracing.responseTimeStamp=response-timestamp` | Defines the response timestamp key. |
89+
| `-Dapi.compliance.tracing.gatewayType=gateway-type` | Defines the gateway type key. |
90+
| `-Dapi.compliance.detect.api={host}}/v1/apiwiz-runtime-agent/compliance/detect` | Sets the API endpoint for compliance detection. |
91+
| `-Dworkspace-id=stage-data` | Sets the workspace ID. |
92+
| `-Dapi.compliance.tracing.enable-tracing=true` | Enables API compliance tracing. |
93+
| `-Dx-apikey={apikey}` | Specifies an API key for authentication. |
94+
| `-Dserver-ip={your_server_ip}` | Sets the server's IP address. |
95+
96+
## Example
97+
98+
```bash
99+
java -javaagent:/path/to/opentelemetry-javaagent.jar \
100+
-Dotel.metrics.exporter=none \
101+
-Dotel.logs.exporter=none \
102+
-Dotel.exporter.otlp.traces.endpoint="https://dev-api.apiwiz.io/v1/apiwiz-runtime-agent/api-visualiser/otel/traces" \
103+
-Dotel.exporter.otlp.traces.headers="x-tenant=stage-data,x-apikey=E5KAHRATn8kjWZbdAVaXTD7FVtCsdXuijm9dRpatlBLJ4gOplbGSMWSOlcn8x1lwyJLgzug1UVfmF%2FduXtk1oa9oG5%2BS6iDGA9zWpTjafpy4U0OT9kBiA5r%2FnDb55MzE4qfKfWXlpAqtEZrDiwtOlR1tjjzdCTEYmqPEfjYgQr7%2FWjIUBU2UQdB6zg2oQUWKBbPf1NY%2BF%2BTZiVcbhbwHibM7%2ByTSeLydksCElDo84GEb06QyoHxkXbB%2BQLWBdw9PvShGJr1e3xnIcf1MupyIPDVfB1WjwqNPSUD%2BKKqtKI%2FOSjQGR4x%2F6ov8zESd1nGQAiEKCvAW5%2FuhF5uVv0A70w%3D%3D" \
104+
-Dotel.exporter.otlp.traces.timeout=600000 \
105+
-Dspring.datasource.url=jdbc:postgresql://localhost:5432/apiwiz \
106+
-Dspring.datasource.username=postgres \
107+
-Dspring.datasource.password=apiwiz \
108+
-Dapi.compliance.tracing.traceId=traceid \
109+
-Dapi.compliance.tracing.spanId=spanid \
110+
-Dapi.compliance.tracing.parentSpanId=parentspanid \
111+
-Dapi.compliance.tracing.requestTimeStamp=request-timestamp \
112+
-Dapi.compliance.tracing.responseTimeStamp=response-timestamp \
113+
-Dapi.compliance.tracing.gatewayType=gateway-type \
114+
-Dapi.compliance.detect.api=https://dev-api.apiwiz.io/v1/apiwiz-runtime-agent/compliance/detect \
115+
-Dworkspace-id=stage-data \
116+
-Dapi.compliance.tracing.enable-tracing=true \
117+
-Dx-apikey=E5KAHRATn8kjWZbdAVaXTD7FVtCsdXuijm9dRpatlBLJ4gOplbGSMWSOlcn8x1lwyJLgzug1UVfmF%2FduXtk1oa9oG5%2BS6iDGA9zWpTjafpy4U0OT9kBiA5r%2FnDb55MzE4qfKfWXlpAqtEZrDiwtOlR1tjjzdCTEYmqPEfjYgQr7%2FWjIUBU2UQdB6zg2oQUWKBbPf1NY%2BF%2BTZiVcbhbwHibM7%2ByTSeLydksCElDo84GEb06QyoHxkXbB%2BQLWBdw9PvShGJr1e3xnIcf1MupyIPDVfB1WjwqNPSUD%2BKKqtKI%2FOSjQGR4x%2F6ov8zESd1nGQAiEKCvAW5%2FuhF5uVv0A70w%3D%3D" \
118+
-Dserver-ip=8.8.8.8 \
119+
-jar my-application.jar
120+
```
88121
89122
## Supported libraries, frameworks, and application servers
90123

0 commit comments

Comments
 (0)
Please sign in to comment.