Troubleshoot the Dynatrace Integration

No Data in Dynatrace Grail

Symptom: Logs are not appearing in the ms_teams bucket.

Checks:

1. Run ./ms-teams-agent.bin --config ./conf/config.yaml --ignore_state and confirm export succeeds.
2. Verify the dynatrace_api_token has the logs.ingest scope.
3. Confirm the dynatrace_tenant_id matches your Dynatrace tenant URL.
4. Check collector logs for export errors (tail -f logs/pheniAgent_<tenant_id>.log).
5. Confirm the Grail bucket ms_teams exists and is active.

Collector Reports Authentication Error to Dynatrace

Symptom: Collector logs show 401 Unauthorized or 403 Forbidden on Dynatrace export.

Checks:

1. Verify the API token is valid and not expired.
2. Confirm the token has logs.ingest permission.
3. Confirm the token is correctly copied (no trailing space or missing characters).

OpenPipeline Not Processing Data

Symptom: Logs arrive in Grail but metrics are not extracted, or data goes to the wrong bucket.

Checks:

1. Open Logs → OpenPipeline and confirm the pipeline is active.
2. Verify the dynamic route pattern matches MSTeams_*.
3. Check the storage assignment in the pipeline points to the ms_teams bucket.
4. Look for pipeline errors in the OpenPipeline diagnostics view.

App Dashboards Show No Data (Live Mode)

Symptom: App is installed and configured, but dashboards remain empty.

Checks:

1. Confirm Live mode is activated in Installation & Configuration.
2. Verify the credential vault reference is correct and the credential is accessible to the app.
3. Confirm at least one full collector cycle has completed.
4. Check that the ms_teams bucket contains recent log records (use Logs Explorer).
5. Review the app’s built-in status or health indicators if available.

Configuration Save Fails in the App

Symptom: Saving settings in Installation & Configuration returns an error.

Checks:

1. Verify the license is valid and correctly applied.
2. Confirm backend endpoint connectivity from the app (outbound hosts allowlist).
3. Check Credential Vault access permissions for the app.

Outbound Connectivity Issues

Symptom: App or collector cannot reach external endpoints.

Checks:

1. In Settings → Preferences → Outbound connections, confirm these hosts are allowed:
   • graph.microsoft.com
   • login.microsoftonline.com
2. If geolocation is enabled, also allow ip-api.com.

Tip

For collector-side connectivity issues (Microsoft Graph authentication, export errors), see Collector Troubleshooting.