OpenTelemetry のバックエンドとしてDynatraceを使ってみる

Posted at 2024-02-10

はじめに

アプリケーション開発においてオブザーバビリティを実現するためにOpenTelemetryを使用するケースが増えているように感じます。
OpenTelemetry自体はテレメトリーデータの生成、収集、管理、出力にフォーカスしており、そのデータを処理しUIを提供するバックエンドのシステムはJaegerやPrometheusのようなOSS製品からDynatraceをはじめとした商用ベンダーまでさまざま利用が可能です。
本記事では、バックエンドとしてDynatraceを用いる方法について紹介します。

環境

Kubernetes環境にOpenTelemetry DemoアプリとOpenTelemetry CollectorをデプロイしてCollector経由でDynatraceへデータを送る方法について試していきます。

OpenTelemetry Demoアプリ

demoアプリ、CollectorともにHelmを使ってインストールしていきます。
デフォルトで用意されているHelm Chartを利用すると全てAll-in-oneでインストールすることができますが、今回はdemoアプリとCollectorで異なるNamespaceにインストールしていきたいと思います。

絵にするとこんな感じです。Ingress等も使って良い感じに外からアクセスできるようにしていきます。

ちなみにKubernetes環境はUbuntu上にMicrok8sで構築しています。

Dynatraceへのテレメトリーデータの送信はActiveGateを経由させていますが、Dynatraceへ直接送信する方法もサポートしています。

DynatraceといえばOneAgentを使ったデータの収集が代表的ですが、今回はCollector経由のみでどのようなデータが収集できるか確認したいためOneAgentは導入しません。

Dynatrace環境の準備

ActiveGateの構築（オプション）

この辺の記事を参考にActiveGateを構築します。

OTLPのエンドポイントは以下のアドレスになります。

https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp

アクセストークンの発行

Dynatraceへデータを取り込むにあたって必要なアクセストークンは以下の3つになります。

シグナル	アクセススコープ
トレース	`openTelemetryTrace.ingest`
メトリクス	`metrics.ingest`
ログ	`logs.ingest`

DynatraceのUIからアクセストークンの発行画面に行き、トークン名を入力して、スコープの検索にopentelemetryと入力すると必要なトークンの一覧が出てきますので3つ全てにチェックを入れてトークンの生成をクリックします。

生成されたトークンは一度しか表示されないため、必要に応じて安全に保存してください。

OpenTelemetry Collectorのデプロイ

この辺を参考にCollector用のvalues.yamlを作成します。

opentelemetry-collector/values.yaml

mode: deployment

config:
  exporters:
    otlphttp/dynatrace:
      endpoint: https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/otlp
      tls:
        insecure_skip_verify: true
      headers:
        Authorization: "Api-Token dt0c01.XXXXX"

  service:
    pipelines:
      traces:
        exporters: [otlphttp/dynatrace]
      metrics:
        exporters: [otlphttp/dynatrace]
      logs:
        exporters: [otlphttp/dynatrace]

resources:
  limits:
    cpu: 250m
    memory: 512Mi

DynatraceはOpenTelemetry ProtocolのHTTPを利用したバイナリーエンコーディング方式にネイティブ対応していますので、otlphttpを指定することが可能です。

helm installコマンドでCollectorのインストールを実行します。

OpenTelemetry Demoのデプロイ

この辺を参考にCollectorやバックエンドがいないDemoアプリ用のvalues.yamlを作成します。

values.yaml

default:
  envOverrides:
    - name: OTEL_COLLECTOR_NAME
      value: my-otel-collector-opentelemetry-collector.otel-col

components:
  frontendProxy:
    ingress:
      enabled: true
      annotations:
        cert-manager.io/cluster-issuer: letsencrypt
        kubernetes.io/ingress.class: public
      hosts:
        - host: otel-demo.example.com
          paths:
            - path: /
              pathType: Prefix
              port: 8080
      tls:
        - hosts:
          - otel-demo.example.com
          secretName: otel-demo-tls

opentelemetry-collector:
  enabled: false

jaeger:
  enabled: false

prometheus:
  enabled: false

grafana:
  enabled: false