メトリクスエクスポーター - 標準出力

この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/otel/metrics/sdk_exporters/stdout/

翻訳元: open-telemetry/opentelemetry-specification v1.60.0（コミット 29ae8c7）

ステータス: Stable

「標準出力」メトリクスエクスポーターはPush Metric Exporterであり、メトリクスをstdout/コンソールに出力します。

このエクスポーターの出力形式は規定されておらず、実装間で異なる場合があります。ドキュメントはこの点についてSHOULD利用者に注意を促すものとします。以下の文言が推奨されます（必要に応じて修正してください）。

This exporter is intended for debugging and learning purposes. It is not recommended for production use. The output format is not standardized and can change at any time.

If a standardized format for exporting metrics to stdout is desired, consider using the File Exporter, if available. However, please review the status of the File Exporter and verify if it is stable and production-ready.

（このエクスポーターはデバッグと学習を目的としています。本番環境での利用は推奨されません。出力形式は標準化されておらず、いつでも変更される可能性があります。

メトリクスをstdoutにエクスポートするための標準化された形式が必要な場合は、利用可能であればFile Exporterの利用を検討してください。ただし、File Exporterのステータスを確認し、それが安定していて本番環境で利用可能な状態かどうかを確かめてください。）

OpenTelemetry SDKの作者は、自分の言語にとって最良のイディオマティックな名前を選んでもかまいません（MAY）。例えば、ConsoleExporter、StdoutExporter、StreamExporterなどです。

「標準出力」メトリクスエクスポーターは、MetricReaderの出力temporalityをInstrument種別の関数として設定する手段をMUST提供するものとします。このオプションはtemporalityと名付けてもかまいません（MAY）が、デフォルトではすべてのInstrument種別についてtemporalityをCumulativeにMUST設定するものとします。

「標準出力」メトリクスエクスポーターは、MetricReaderのデフォルトのaggregationをInstrument種別の関数として設定する手段を提供してもかまいません（MAY）。このオプションはdefault_aggregationと名付けてもかまいません（MAY）が、デフォルトではデフォルトの集約をMUST使用するものとします。

言語が、関連するエクスポーターと組み合わせるMetricReaderを自動的に設定する仕組み（例えばOTEL_METRICS_EXPORTER環境変数を使うなど）を提供している場合、デフォルトではこのエクスポーターは、デフォルトのexportIntervalMillisecondsが10000であるperiodic exporting MetricReaderとMUST組み合わされるものとします。