Skip to content

Commit 3061e69

Browse files
Update tracing-in-runtime.md
1 parent ead2b8c commit 3061e69

1 file changed

Lines changed: 14 additions & 14 deletions

File tree

content/en/docs/refguide/runtime/tracing-in-runtime.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -161,12 +161,9 @@ To use the OpenTelemetry Collector with Datadog, follow these steps:
161161

162162
## Sending Traces from Mendix on Kubernetes
163163

164-
Mendix on Kubernetes can send OpenTelemetry traces to a standards-compliant OpenTelemetry Collector.
164+
Mendix on Kubernetes can send OpenTelemetry traces to a standards-compliant OpenTelemetry collector.
165165

166-
Some cloud providers provide OpenTelemetry instrumentation Agents and will not work with the Mendix Runtime.
167-
For example:
168-
169-
* [Azure Application Insights](https://learn.microsoft.com/en-us/azure/azure-monitor/app/opentelemetry-enable) is incompatible with the standard OpenTelemetry instrumentation Agent bundled with the Mendix Runtime.
166+
Some cloud providers provide OpenTelemetry instrumentation agents and will not work with the Mendix Runtime. For example, [Azure Application Insights](https://learn.microsoft.com/en-us/azure/azure-monitor/app/opentelemetry-enable) is incompatible with the standard OpenTelemetry instrumentation agent bundled with the Mendix Runtime.
170167

171168
### Installing Jaeger from a Helm chart
172169

@@ -175,11 +172,11 @@ To get an OpenTelemetry collector installed into a Kubernetes cluster, contact y
175172
For quick experiments or non-production use cases, Jaeger can be installed using the [official Helm chart](https://github.com/jaegertracing/helm-charts/tree/jaeger-4.7.0/charts/jaeger).
176173

177174
{{% alert color="warning" %}}
178-
The default Jaeger configuration is not production-grade: it doesn't have any authentication and stores all traces in-memory.
179-
180-
To get a production-grade OpenTelemetry collector installed into a Kubernetes cluster, contact your cluster admin.
175+
The default Jaeger configuration is not production-grade, because it does not have any authentication and stores all traces in memory. To get a production-grade OpenTelemetry collector installed into a Kubernetes cluster, contact your cluster admin.
181176
{{% /alert %}}
182177

178+
#### Kubernetes Cluster
179+
183180
To install Jaeger into a Kubernetes cluster (except OpenShift), run the following commands in a Bash prompt:
184181

185182
```shell
@@ -189,6 +186,8 @@ helm install $HELM_RELEASE jaegertracing/jaeger --version='~4.7' \
189186
--set storage.type=memory
190187
```
191188

189+
#### OpenShift Cluster
190+
192191
To install Jaeger into an OpenShift cluster, run the following commands in a Bash prompt:
193192

194193
```shell
@@ -199,24 +198,28 @@ helm install $HELM_RELEASE jaegertracing/jaeger --version='~4.7' \
199198
--set jaeger.podSecurityContext=null
200199
```
201200

201+
#### Accessing the Jaeger Web UI
202+
202203
To access the Jaeger web UI, run the following command in a Bash prompt:
203204

204205
```shell
205206
HELM_RELEASE=mx-jaeger
206207
kubectl port-forward svc/${HELM_RELEASE} 16686:16686
207208
```
208209

210+
#### Sending Traces
211+
209212
To send traces to this OpenTelemetry Collector, use the following hostname format (where `${HELM_RELEASE}` is the value of `HELM_RELEASE` used during installation, and `${NAMESPACE}` is the namespace where the Jaeger Helm chart was installed):
210213

211214
```
212215
${HELM_RELEASE}.${NAMESPACE}.svc.cluster.local
213216
```
214217

215-
for example, `mx-jaeger.example-namespace.svc.cluster.local`.
218+
For example, `mx-jaeger.example-namespace.svc.cluster.local`.
216219

217220
### OpenTelemetry Collector
218221

219-
To send logs and traces from a Mendix on Kubernetes environment to an OpenTelemetry collector, set the _Custom JVM Options_ to :
222+
To send logs and traces from a Mendix on Kubernetes environment to an OpenTelemetry collector, set the _Custom JVM Options_ to the following:
220223

221224
```
222225
-javaagent:/opt/mendix/runtime/agents/opentelemetry-javaagent.jar -Dotel.javaagent.extensions=/opt/mendix/runtime/agents/mendix-opentelemetry-agent-extension.jar -Dotel.service.name=${APP_NAME} -Dotel.exporter.otlp.traces.endpoint=http://${OTEL_HOST}:4318/v1/traces -Dotel.exporter.otlp.traces.protocol=http/protobuf
@@ -228,10 +231,7 @@ Depending on how the OpenTelemetry Collector is configured, the values of `-Dote
228231

229232
## Include Metrics and Logs in OpenTelemetry
230233

231-
You can also collect metrics data (CPU load, memory, etc.) and logs using OpenTelemetry.
232-
233-
* See the [OpenTelemetry](/refguide/metrics/#opentelemetry) section of *Metrics* for a guide on how to setup metrics with OpenTelemetry.
234-
* See [Request to Create New Log Subscriber in Open Telemetry Format](/refguide/monitoring-mendix-runtime/#new-log-sub-opentelemetry) in *Monitoring Mendix Runtime* for a guide on how to setup logs with OpenTelemetry.
234+
You can also use OpenTelemetry to collect logs and metrics data (CPU load, memory, and others). For more information about setting up metrics with OpenTelemetry, see the [OpenTelemetry](/refguide/metrics/#opentelemetry) section of *Metrics*. For a guide on how to set up logs with OpenTelemetry, see [Request to Create New Log Subscriber in Open Telemetry Format](/refguide/monitoring-mendix-runtime/#new-log-sub-opentelemetry) in *Monitoring Mendix Runtime*.
235235

236236
## Custom Spans in Java Actions
237237

0 commit comments

Comments
 (0)