Skip to main content
Honeycomb のチームを接続すると、Alex（Cloud Engineer）がトレースをクエリし、失敗しているエンドポイントを順位付けし、BubbleUp で何が変わったかを特定し、トレースウォーターフォールをたどって失敗したスパンに到達できます。 Honeycomb は Honeycomb がホストする MCP サーバー経由で OAuth 認証を行うため、API キーを作成したり認証情報を CloudThinker に貼り付けたりする必要はありません。

​
前提条件

  • CloudThinker に読み取らせたいチームへアクセスできる Honeycomb アカウント。
  • Honeycomb の OAuth フローで CloudThinker を認可する権限。
  • テレメトリーを受信しているデータセットを持つ environment が少なくとも 1 つ。すべてのクエリツールはデータセットを必要とします。データセットのない environment は、正常でゼロなのではなく、テレメトリーが送られていないことを意味します。
CloudThinker は Honeycomb の US エンドポイント https://mcp.honeycomb.io/mcp に接続します。EU エンドポイントは選択できないため、EU のみのチームはまだ接続できません。

​
セットアップ

1

接続を開く

CloudThinker ワークスペースで Connections → Honeycomb に移動します。
2

OAuth フローを開始する

Connect をクリックします。CloudThinker が Honeycomb の認可ページを開きます。
3

CloudThinker を認可する

使用したいチームにアクセスできる Honeycomb アカウントでサインインし、アクセスを承認します。
4

CloudThinker に戻る

Honeycomb が元の画面に戻し、CloudThinker がトークンを保存します。接続に Connected ステータスが表示されます。

​
接続の詳細

Honeycomb は OAuth を使用するため、入力する項目はありません。CloudThinker はフロー完了後にアクセストークンとリフレッシュトークンを保存し、再度尋ねることなく更新します。

​
必要な権限

CloudThinker は認可したアカウントがアクセスできる範囲をそのまま引き継ぎます。認可では 2 つのスコープが付与されます。
エージェントに見せたいチームに限定したアカウントで認可してください。CloudThinker はそのアカウントが既に持つ権限より狭く絞ることはできません。

​
エージェントの機能

接続すると、Alex は次のことができます。

​
接続を確認する

​
プロンプト例

​
書き込みは取り消せません

Honeycomb の MCP サーバーには削除ツールがありません。エージェントが作成したボード、トリガー、SLO、マーカー、レシピエントは CloudThinker からは削除できず、Honeycomb 側で削除します。 そのため、すべての書き込みは二重にゲートされます。エージェントが影響と正確な入力内容を提示し、そのターンであなたが承認した後にのみ変更が実行されます。
そのオブジェクトを残し続けてよい場合にのみ作成を承認してください。CloudThinker から取り消す手段はありません。

​
トラブルシューティング

ブラウザが別の Honeycomb アカウントでサインインしている可能性があります。目的のアカウントでサインインし直し、Honeycomb 接続をやり直してください。
保存されたトークンが無効です。多くの場合、Honeycomb 側で認可が取り消されています。接続を削除して再接続してください。
クエリにはクエリ可能な environment 内のデータセットが必要です。その environment が Honeycomb でテレメトリーを受信しているか確認してください。データセットのない environment では、クエリ、BubbleUp、トレースの質問に答えられません。
$activity-log$ は Honeycomb 自身の監査用 environment です。environment 一覧には表示されますが、スコープ付きの呼び出しはすべて拒否されるため、CloudThinker は意図的にスキップします。
ボード、トリガー、SLO、マーカー、レシピエントの作成には同じターン内でのあなたの承認が必要です。承認プロンプトが開いている間に応答してください。新しいターンでは再度尋ねられます。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • 結果リンクをチャットに出さない — Honeycomb はクエリ結果とトレース結果のダウンロード URL に署名します。CloudThinker は人間向けのパーマリンクのみを共有するため、コピーされたメッセージが結果へのアクセス権を持つトークンを運ぶことはありません。
  • チームを切り替えるときは再接続する — 別の Honeycomb アカウントを認可する前に、既存の接続を削除してください。

​
関連

Alex エージェント

クラウドとオブザーバビリティの調査エージェント

承認

CloudThinker が書き込みを確認の後ろでゲートする仕組み