Configuring Runtime Observability

This topic guides you through the steps to configure Observability settings for your basic runtimes, runtime cluster, and runtime clouds to export telemetry data via OpenTelemetry.

note

Not supported for cloud attachments.

Prerequisites

1. Have a locally installed Boomi runtime.
2. Have Runtime Management privileges.

Observability Tooling Prerequisites

1. Install or reference a third party application monitoring tool that supports OpenTelemetry (list of supported vendors).
2. Optional: Instead of installing a third party application, you can Install and configure a local collector.
   1. URL and port
   2. Authentication - If required, typically will be a user name and password, or API token.

Configuration

1. From the Runtime Management page, click Observability from the menu options, then toggle the Enable Observability switch to on.
2. Configure global endpoint information to where telemetry data should be sent. Note this can be overridden per signal type below.
   1. URL - Endpoint for monitoring application or collector. Must be accessible to the runtime.
   2. Authentication Type - If applicable, the authentication type and credentials required to access the monitoring application or collector.
3. Enter configuration details to customize your observability settings.
   1. Enable and configure metrics telemetry export
      1. Enable metrics to begin exporting runtime application metrics.
      2. Optional - Override metrics endpoint if need to send the metrics to a different monitoring endpoint.
      3. Optional - Configure advanced settings to optimize transmission as needed.
   2. Enable and configure logs telemetry export.
      1. Enable logs to begin exporting runtime and process execution logs.
      2. Optional - Override logs endpoint if need to send the logs to a different monitoring endpoint.
      3. Choose to export all logs or only selected logs.
      4. Optional - Configure advanced settings to optimize transmission as needed.
   3. Enable and configure traces telemetry export.
      1. Enable traces to begin exporting process execution traces.
      2. Optional - Override traces endpoint if need the traces to send to a different monitoring endpoint.
      3. Choose to export traces for all processes or only selected processes.
      4. Optional - Configure advanced settings to optimize transmission as needed.
4. Save
   1. Optional - Select Yes, restart the plugin now.
      NOTE: When enabling observability, the observability plugin must be restarted. Keep in mind observability data is not generated nor exported while the runtime or plugin is restarting.
5. SUCCCESS! Your observability settings are now configured.

OPTIONAL. You can also configure observability settings via the RuntimeObservabilitySettings API.