データの違いについてこのデータセットは毎日午前 0 時から再生されるため、デモを確認するタイミングによって表示される可視化は異なる場合があります。
デモシナリオ
OpenTelemetry デモ
デモアーキテクチャ
デモの手順
1
デモサーバーに接続する
ローカル専用モードLocal Mode でデプロイする際に
Connect to Demo Server をクリックした場合、この手順は省略できます。このモードを使用する場合、ログソースには Demo_ プレフィックスが付きます (例: Demo_Logs) 。Team Settings に移動し、Local Connection の Edit をクリックします。接続名を Demo にリネームし、続いて表示されるフォームにデモサーバー用の以下の接続情報を入力します。Connection Name:DemoHost:https://sql-clickhouse.clickhouse.comUsername:otel_demoPassword: 空のままにします
2
ログソースを変更する
ローカル専用モードLocal Mode でデプロイするときに
Connect to Demo Server をクリックした場合は、この手順をスキップできます。このモードを使用する場合、ログソースには Demo_ というプレフィックスが付きます (例: Demo_Logs)Sources に戻り、各ログソース (Logs、Traces、Metrics、Sessions) が otel_v2 データベースを使用するように変更します。各ログソースでデータベースの一覧全体が表示されるようにするには、ページの再読み込みが必要になる場合があります。
3
時間範囲を調整
右上のタイムピッカーを使って時間範囲を調整し、直前の
1 day のすべてのデータが表示されるようにします。概要の棒グラフでは、エラー数にわずかな違いが見られ、連続するいくつかのバーで赤色が少し増えていることがあります。バーの位置は、データセットに対してクエリを実行するタイミングによって異なります。
4
エラーに絞り込む
エラーの発生箇所を目立たせるには、
SeverityText フィルターを使用し、error を選択してエラーレベルの項目だけを表示します。これで、エラーがよりわかりやすくなるはずです。5
エラーのパターンを特定する
HyperDX のクラスタリング機能を使うと、エラーを自動的に特定し、意味のあるパターンにグループ化できます。これにより、大量のログやトレースを扱う際の分析を迅速化できます。使用するには、左側のパネルにある
Analysis Mode メニューから イベントパターン を選択します。エラークラスターからは、Failed to place order という名前のパターンを含め、支払い失敗に関連する問題が明らかになります。さらに、カード請求の問題や cache の容量不足を示すクラスターも確認できます。これらのエラークラスターは、異なるサービスで発生している可能性が高い点に注意してください。6
エラーパターンを確認する
ユーザーが支払いを完了できるという報告済みの問題と相関する、最もわかりやすいエラークラスター
Failed to place order をクリックします。これにより、frontend サービスに関連付けられたこのエラーの発生一覧がすべて表示されます。表示されたエラーのいずれかを選択します。ログのメタデータが詳細に表示されます。概要 と Column Values を見ていくと、cache が原因でカード請求に問題が発生していることが示唆されます。failed to charge card: could not charge the card: rpc error: code = Unknown desc = Visa cache full: cannot add new item.7
Exploreでインフラストラクチャを確認する
cache に関連するエラーが、支払い失敗の原因となっている可能性が高いことがわかりました。この問題がマイクロサービス アーキテクチャのどこで発生しているのかは、まだ特定できていません。cache の問題を踏まえると、基盤となるインフラストラクチャを調査するのが妥当です。関連するポッドでメモリの問題が発生している可能性もあります。ClickStack では、ログとメトリクスが統合され、コンテキストに沿って表示されるため、根本原因をすばやく突き止めやすくなります。
frontend サービスの基盤となるポッドに関連付けられたメトリクスを表示するには、Infrastructure タブを選択し、時間範囲を 1d に広げます。この問題は、インフラストラクチャに関連しているようには見えません。エラーの前後を問わず、この期間を通して顕著に変化しているメトリクスはありません。Infrastructure タブを閉じます。8
トレースを調べる
ClickStack では、トレースはログとメトリクスの両方にも自動的に相関付けられます。どのサービスが原因なのかを特定するために、選択したログにリンクされたトレースを見てみましょう。関連するトレースを可視化するには
Trace を選択します。続くビューを下にスクロールすると、HyperDX が各サービスのスパンをつなぎ、マイクロサービス全体にまたがる分散トレースをどのように可視化しているかがわかります。決済には明らかに複数のマイクロサービスが関与しており、その中にはチェックアウト処理や通貨換算を行うものも含まれます。ビューの一番下までスクロールすると、payment サービスがエラーの原因となっており、それが呼び出しチェーンをさかのぼって伝播していることがわかります。9
トレースの検索
cache の問題により、payment サービスでユーザーが購入を完了できていないことが確認できました。根本原因についてさらに詳しく把握するため、このサービスのトレースをもう少し詳しく見ていきましょう。
Search を選択してメインの Search view に切り替えます。Traces のデータソースに切り替え、Results table ビューを選択します。期間が引き続き過去1日になっていることを確認してください。このビューには、過去1日分のすべてのトレースが表示されます。問題は payment サービスで発生していることがわかっているため、ServiceName に payment フィルターを適用します。Event Patterns を選択してトレースにイベントクラスタリングを適用すると、payment サービスの cache の問題をすぐに確認できます。10
Explore でトレースのインフラストラクチャを確認する
Results table をクリックして結果ビューに切り替え、StatusCode フィルターと Error 値でエラーに絞り込みます。Error: Visa cache full: cannot add new item. のエラーを 1 つ選択し、Infrastructure タブに切り替えて期間を 1d に広げます。トレースとメトリクスを相関させると、payment サービスでメモリと CPU が増加したあと、0 まで低下していることがわかります (これはポッドの再起動によるものと考えられます) 。このことから、cache の問題がリソース問題を引き起こした可能性が示唆されます。その結果、支払い完了時間にも影響が出ていると考えられます。11
より迅速な原因究明のためのイベントデルタ
イベントデルタは、パフォーマンスやエラー率の変化を特定のデータの部分集合に関連付けることで異常を浮かび上がらせ、根本原因をすばやく特定しやすくします。
payment サービスに cache の問題があり、その結果リソース消費が増加していることは分かっていますが、根本原因はまだ完全には特定できていません。結果テーブルビューに戻り、エラーが含まれる時間範囲を選択してデータを絞り込みます。エラーより前の数時間分と、可能であれば後の時間帯も選択してください (問題がまだ発生している可能性があります) 。errors フィルターを削除し、左側の Analysis Mode メニューから Event Deltas を選択します。上部のパネルには所要時間の分布が表示され、色はイベント密度 (スパン数) を示します。主な集中領域の外側にあるイベントの部分集合は、通常、調査する価値があります。1ms を超える継続時間のイベントを選択し、Filter by selection フィルターを適用すると、“normal” なイベントと、継続時間が約 0ms のスパンが高密度に集まったグループとの差異を分析できます。このデータの部分集合に対して分析を行うと、選択範囲外の “background” スパンの大半が Visa トランザクションであり、cache error による 0ms のレスポンスに関連していることが分かります。12
チャートでより詳しく把握する
ClickStack では、ログ、トレース、メトリクス内の任意の数値をチャート化し、より詳しいコンテキストを把握できます。ここまでで、次のことが分かっています。
左側のメニューから
- 問題は payment service にある
- cache がいっぱいになっている
- その結果、リソース消費量が増加した
- この問題により Visa の支払いは完了できなくなった、あるいは少なくとも完了までに非常に長い時間がかかるようになった。
左側のメニューから
Chart Explorer を選択します。支払い完了までにかかる時間をチャート化するため、以下の値を設定します。Data Source:TracesMetric:MaximumSQL Column:DurationWhere:ServiceName: paymentTimespan:Last 1 day
▶️ をクリックすると、支払いのパフォーマンスが時間の経過とともにどのように低下したかを確認できます。Group By を SpanAttributes['app.payment.card_type'] に設定すると (オートコンプリートを使うには card とだけ入力します) 、Mastercard と比べて Visa トランザクションでサービスのパフォーマンスがどのように低下したかを確認できます。なお、エラーが発生すると、レスポンスは 0s で返るようになります。13
メトリクスの確認に関する補足情報
最後に、cache サイズをメトリクスとしてプロットし、時間の経過に伴ってどのように推移したかを確認して、より多くのコンテキストを得ましょう。次の値を入力します:
Data Source:MetricsMetric:MaximumSQL Column:visa_validation_cache.size (gauge)(cacheと入力するだけでオートコンプリートされます)Where:ServiceName: paymentGroup By:<empty>
100,000 に達したことがわかります。Sample Matched Events からは、cache がこの上限に達したタイミングとエラーが相関していること、またその後はサイズが 0 と記録され、レスポンスも 0s で返されるようになっていることがわかります。要約すると、logs、traces、そして最後にメトリクスを調査することで、次のことがわかりました:- 問題は payment service にあります
- おそらくデプロイメントに伴うサービス動作の変更により、4〜5時間にわたって visa cache が徐々に増加し、最大サイズ
100,000に達しました - その結果、cache のサイズ増大に伴って consumption も増加しました。おそらく実装上の問題が原因です
- cache が増大するにつれて、Visa 決済のパフォーマンスは低下しました
- 最大サイズに達すると、cache は決済を拒否し、自身のサイズを
0と報告しました。
14
セッションの使用
セッションを使うとユーザー体験を再生でき、ユーザーの視点から
error がどのように発生したかを視覚的に確認できます。通常、根本原因の特定に使われることはあまりありませんが、カスタマーサポートに報告された問題の確認には有用で、より詳しい調査の出発点にもなります。HyperDX では、セッションはトレースやログに関連付けられており、根本原因まで含めて全体像を把握できます。たとえば、サポートチームから支払いに問題が発生したユーザーのメールアドレス Ronny.Windler@gmail.com が共有された場合、ログやトレースを直接検索するよりも、まずそのユーザーのセッションから確認するほうが効果的なことがよくあります。左側のメニューから Client Sessions タブを開き、データソースが Sessions、時間範囲が Last 1 day に設定されていることを確認します。SpanAttributes.userEmail: Ronny.Windler を検索して、対象の顧客のセッションを見つけます。セッションを選択すると、左側にその顧客のセッションに対応するブラウザーイベントと関連するスパンが表示され、右側にはユーザーのブラウザー操作が再現されます。15
セッションのリプレイ
▶️ ボタンを押すと、セッションを再生できます。
Highlighted と All Events を切り替えることで、span の粒度を変更でき、前者では主要なイベントとエラーが強調表示されます。span の一番下までスクロールすると、/api/checkout に関連する 500 エラーを確認できます。この特定の span の ▶️ ボタンを選択すると、再生位置がセッション内のこの時点に移動するため、顧客の体験を確認できます。支払いは単に機能していないように見え、エラーも表示されていません。span を選択すると、これが内部エラーによって発生したことを確認できます。Trace タブをクリックし、接続されている span をスクロールしていくことで、この顧客が実際に当社の cache の問題の影響を受けていたことを確認できます。