オライリー『Learning OpenTelemetry』の邦訳が、オライリージャパンから『入門OpenTelemetry』として刊行された。
縁があって本書の翻訳レビューに関わったが、本書の内容はオブザーバビリティの事実上標準技術である「OpenTelemetry」の概要を掴むのに最適だ。
OpenTelemetryはCNCF（Cloud Native Computing Foundation）のincubatingプロジェクト。オープンソース、ベンダー非依存な体制で、テレメトリの収集・送信の標準と、それを扱うためのフレームワークを提供している。メトリック、ログ、トレース、プロファイルなどのテレメトリシグナルを手広く仕様およびリファレンスライブラリ実装としてカバーし、共通する情報の持ち方を定めることで、それぞれのシグナルがばらばらになることを防ぎ、関係性を持ってオブザーバビリティプラットフォームで解析できるようになる。
逆に、シグナルをどう解析するか、どうビジュアライズするか、どうアラートにつなげるかというのはOpenTelemetryプロジェクトの責任範疇ではなく、シグナルを最終的に受け取るオブザーバビリティプラットフォームに委ねられている。
OpenTelemetryプロジェクトの共同設立者たちの手による、「公式」とも呼べそうな本書は、技術詳細・コードには深入りしすぎない範囲で、OpenTelemetryがオブザーバビリティにもたらす価値と世界観を概説している。
章構成は以下のとおり。
- 1章 最新のオブザーバビリティの現状
- 2章 なぜOpenTelemetryを使うのか
- 3章 OpenTelemetry概要
- 4章 OpenTelemetryのアーキテクチャ
- 5章 アプリケーションの計装
- 6章 ライブラリの計装
- 7章 インフラストラクチャの観測
- 8章 テレメトリーパイプラインの設計
- 9章 オブザーバビリティの展開
- 付録A OpenTelemetryプロジェクト
- 付録B さらなる資料
コンパクト（212ページ）で1章ごとに要点がまとまっており、退屈せずにすらすらと読むことができるだろう。
導入の第1〜3章では、OpenTelemetryがオブザーバビリティ界隈においてなぜ重要なファクターとなってきているのかを知ることができる。オブザーバビリティに何らかの形で関わっているのなら、この3章ぶんだけでも読む価値はある。
印象的なページとして、第1章で図示される「シグナルの三つ編み」（サイロ化された柱ではなく相互に組み合わせながら洞察する）は、「オブザーバビリティの3本柱」と見聞きするたびに自身がなんとなくしっくりこないと感じていたところに、実に膝を打つ表現だった。
大袈裟に言えば、本書の刊行後は、オブザーバビリティ界隈において柱という表現から編みの表現にトレンドが移るのではないかとさえ思う（原書は昨年に刊行しており、そんなに海外製品の表現が変わった気もしないので、思い込み強すぎ説はもちろんある）。
第4〜7章では、アプリケーションエンジニアやSRE、インフラエンジニアが、サービスを構成するアプリケーションやインフラにOpenTelemetryの計装をする手法を概説している。深入りしない範囲で、それぞれのレイヤーでの計装手段、注意事項、得られるメリットがまとまっており、必要なところだけを拾い読みしてもいいだろう。
実際のところ、OpenTelemetryのSDK、ライブラリなどはまだ安定していない印象がある（全般にトレース実装については各所充実・安定的に見えるが）。このあたりは当面、各種ドキュメントやライブラリの開発プロジェクトの動向をウォッチして変化に追従していくしかなさそうだ。
第8章は毛色を少し変えて、テレメトリを受け取って処理するパイプラインを説明している。テレメトリを欠落させないためのコレクタの構成、フィルタリングとサンプリング、変換、PIIのような機微データの処理などが語られる。
第8章の以下の文はとても好きだ。
トレースは、エラーやタイムアウトにつながるすべてのイベントを簡単に見つけられる、豊富で、よく整理されたログであることを忘れないでください。ログをサンプリングすることが悪いことのように思えるのなら、なぜトレースをサンプリングしたいのでしょうか。
最後の第9章では、組織・ビジネスにオブザーバビリティおよびOpenTelemetryエコシステム導入がもたらす価値を説明し、導入計画をどう進めていくかのチェックリストを提示する。
「私たちは、OpenTelemetryの導入を成功させるためには、一連の基本的な行動が必要であることを長年にわたって見出してきました」という著者の言から始まる、「管理職は関与しているか」「小さくても重要な最初の目標を設定しましたか」など7つからなるチェックリストは、オブザーバビリティ導入オンボーディングに借用できるなと思った。
オブザーバビリティ方面の書籍としてはこちらもオライリージャパンの『オブザーバビリティ・エンジニアリング』も良い本だが、まずは本書を読んでからのほうが、挫折せずに理解できるだろう。
本書の翻訳レビュー行為自体、自分自身の知見を広げるのにとても役立ち、その後の活動に大きく活かせているので最高体験だった。機会をいただいたことに感謝。
