Skip to content
MS Teams Observability MS Teams Observability

Connect the Collector to OTLP Backends (Dynatrace, Datadog, Grafana)

Collector Output Configuration

Section titled “Collector Output Configuration”

Add an otel entry under the output section of your config.yaml:

output:
  otel:
    - name: "my-otel-backend"
      enabled: true
      endpoint: "https://your-otlp-endpoint/v1/logs"
      service_name: "ms-teams-agent"
      deployment_environment: "prod"
      headers:
        Authorization: "Bearer <token>"

Parameters

Section titled “Parameters”
ParameterRequiredDescription
nameYesIdentifier for this OTLP output (used in logs)
enabledYesSet to true to activate the OTLP output
endpointYesFull URL of the OTLP logs endpoint
service_nameNoService name attached to exported logs
deployment_environmentNoEnvironment label attached to exported logs
headersNoHTTP headers, usually used for authentication

Datadog OTLP Configuration

Section titled “Datadog OTLP Configuration”
output:
  otel:
    - name: "datadog"
      enabled: true
      endpoint: "https://otlp.datadoghq.com/v1/logs"
      service_name: "ms-teams-agent"
      deployment_environment: "prod"
      headers:
        DD-API-KEY: "<api-key>"

Detailed setup: OTLP to Datadog.

Dynatrace OTLP Configuration

Section titled “Dynatrace OTLP Configuration”
output:
  otel:
    - name: "dynatrace"
      enabled: true
      endpoint: "https://{your-tenant}.live.dynatrace.com/api/v2/otlp/v1/logs"
      service_name: "ms-teams-agent"
      deployment_environment: "prod"
      headers:
        Authorization: "Api-token <token>"

Validate the Connection

Section titled “Validate the Connection”

After editing the configuration, run:

Terminal window
ms-teams-agent validate --config ./config.yaml
ms-teams-agent test-connection --config ./config.yaml
ms-teams-agent run --config ./config.yaml --dry-run

Verify Data Arrival

Section titled “Verify Data Arrival”
  1. Datadog: confirm logs arrive in Log Explorer and contain Teams event families.
  2. Dynatrace OTLP: confirm logs arrive in Logs/Grail with expected source fields.
  3. Generic OTLP receiver: confirm records are visible with the configured service_name.
  4. If data is not arriving, check collector logs and then follow Collector Troubleshooting.

✅ Success criteria:

  • Collector logs confirm OTLP export with no errors
  • Your OTLP platform shows logs from service_name = "ms-teams-agent"
  • Event families (MSTeams_CallRecords_*) are visible in the platform

❌ If this fails: