Share
Embed
OpenTelemetryを使ってアプリケーションのメトリクスを取る / Kofu.なんか #1 #kofuasterisk
https://houtoupm.connpass.com/event/357176/ でOpenTelemetryでメトリクスを取る話をしました。
Azuki-bar
August 16, 2025
Transcript
51 slides
-
お前だれ - X: @azukibar_D - GitHub: Azuki-bar - 株式会社はてなでアプリケーションエンジニア として働いています
- toittaという生成AIを活用した発話分析ソリューション を作っています 2 -
オブザーバビリティの実現? - サービスの状態(=Signals)を取る - メトリクス - トレース - ログ -
(将来的には)プロファイル? - 取った状態を表現するプロトコル - データの命名規則 8 -
オブザーバビリティの実現? - サービスの状態(=Signals)を取る - メトリクス - トレース - ログ -
(将来的には)プロファイル? - 取った状態を表現するプロトコル - データの命名規則 9 -
メトリクス - サービスに関する時系列データ - CPU使用率, アクセス数, etc… - 適切に取得すると、異変を認知したりコン ピュートリソースを調整できたりする
- メトリックが単数形で、メトリクスが複数形 10 -
計装 - メトリクスなどSignalsを取得すること - 方法はふたつ - APIとSDKを使って自分で取得するコードを書く - Code-based solutions
- Zero-codeでいい感じにしてくれるくんを入れる 11 -
計装 - メトリクスなどSignalsを取得すること - 方法はふたつ - APIとSDKを使って自分で取得するコードを書く - Code-based solutions
- Zero-codeでいい感じにしてくれるくんを入れる 12 -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 17 -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 18 PeriodicExportingMe tricReader メモリに抱えつつ、定 期的に外部へ送信する -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 19 gRPCでメトリクスを吐 く実装 -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 20 4317でgRPCを、4318で HTTPをリッスンしている のが一般的 -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 21 今回は省略しているが、ト レースや自動計装する設定 もここに書く -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 22 最後にstartする 省略しているが、 sdk.shutdown()もある -
APIを呼ぶ import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('default'); const counter = meter.createCounter('custom.foo'); counter.add(1); 23 -
APIを呼ぶ import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('default'); const counter = meter.createCounter('custom.foo'); counter.add(1); 24 Meter(後述)を取得 -
APIを呼ぶ import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('default'); const counter = meter.createCounter('custom.foo'); counter.add(1); 25 Counter, Gauge, Histogramから選んで、値を 記録するためのインスタンスを作る -
APIを呼ぶ import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('default'); const counter = meter.createCounter('custom.foo'); counter.add(1); 27 実際に値を記録する -
めでたしめでたし - ここまでやれば大体値が取れる - あとは好みのSaaSだったり, OTel Collectorだったりに 送る - 疑問に思う
- なんでSDKとAPI分かれているの? - getMeterってどこから何をgetしているの? 28 -
OTel API - > トレース、メトリクス、およびロギングデー タを生成および相関させるためのデータ型と操 作を定義します。 - https://opentelemetry.io/ja/docs/concepts/compo nents/
- 要はインターフェース(I/F)だけを定義してい る - ここでのI/Fは、I/Fに依存するなどの文脈のI/F 32 -
OTel SDK - > 言語固有のAPI実装の要件を定義します。設 定、データ処理、エクスポートの概念もここで 定義されます。 - https://opentelemetry.io/ja/docs/concepts/compo nents/
- 具体の実装 - APIで定義されたI/Fから呼ばれる実体 33 -
OTel SDKを初期化する import { NodeSDK } from '@opentelemetry/sdk-node'; import {
PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics'; import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc'; const sdk = new NodeSDK({ metricReader: new PeriodicExportingMetricReader({ exporter: new OTLPMetricExporter({ url: 'http://127.0.0.1:4317', }), }), }); sdk.start(); 34 設定 エクスポート -
これってもしや? - まさに依存性逆転の原則 - ライブラリはAPIにだけ依存していると嬉しい - ライブラリを使う側で実装を差し変えられる - 実装 -
signalsの送信先やサンプリングなど - これらはSDKでユーザーが定義している 35 -
APIを呼ぶ(再掲) import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('foo'); const counter = meter.createCounter('custom.foo'); counter.add(1); 37 -
APIを呼ぶ(再掲) import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('foo'); const counter = meter.createCounter('custom.foo'); counter.add(1); 40 -
APIを呼ぶ(再掲) import * as OTel from '@opentelemetry/api'; const meter =
OTel.metrics.getMeter('foo'); const counter = meter.createCounter('custom.foo'); counter.add(1); 41 どこからgetMeter しているの? -
getMeterの型定義 export declare class MetricsAPI { /** * Returns a
meter from the global meter provider. */ getMeter(name: string, version?: string, options?: MeterOptions): Meter; } 42 https://github.com/open-telemetry/opentelemetry-js/blob/927032ffd956eac7 3d0a1a98212aded9bf8a0107/api/src/api/metrics.ts#L29-L77 より。一部改変 -
50 感想 - OpenTelemetryの世界は広い - 今は無知を知った状態 - 「依存関係逆転だこれ」と思えたの良かった - 過去の経験が活きているのを実感
- こういう発見ができる領域を増やしたい -
今後への宿題 - キーワードは聞いたけど知らない概念 - Semantic Conventions - OTel Collectorでどんなことできるの -
OpenTelemetry実装への興味 - 他言語ではどうなっているのか - 自動計装はどうやって実装されているのか 51