@@ -72,19 +72,52 @@ java -javaagent:path/to/opentelemetry-javaagent.jar \
72
72
73
73
## Configuring the Agent
74
74
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
+ ` ` `
88
121
89
122
# # Supported libraries, frameworks, and application servers
90
123
0 commit comments