traceway-learn

Traceway を知る

Traceway はオブザーバビリティプラットフォームです。アプリケーションはテレメトリを送信します。バックエンドからは OTLP/HTTP 経由の OpenTelemetry を、ブラウザーやモバイルアプリからは Traceway SDK を送信します。Traceway はそれを、イシュー、リクエストとタスクの分析、トレース、ログ、メトリクスとダッシュボード、セッションリプレイ、AI のコスト追跡、プロファイルに変換します。さらに、稼働監視、公開ステータスページ、アラート、オンコール通知も実行します。

このガイドでは、製品のあらゆる部分について説明します。各ページに表示される内容、使用される用語、チームでの利用方法、そしてエージェントが traceway CLI または MCP サーバーを通じて情報を読み取ったり変更したりする方法を紹介します。

このガイドの使い方

• 「X はどのように動作しますか」「X はどこにありますか」「X は何を意味しますか」という質問には、以下のトピックファイルを参照して回答します。質問に必要なファイルを 1 つか 2 つだけ読みます。
• ユーザーがダッシュボード上で見つけられるよう、ダッシュボードで使用されている正確な名前（タブ名、ボタン、ルールの種類）を引用します。
• ユーザーがリアルタイムデータを求めている場合は、traceway スキル（または MCP ツール）に切り替えます。デバッグとパフォーマンスのプレイブックはそこにあります。
• ユーザーが何かの変更を求めている場合、エージェントが実行可能な変更については traceway-write スキルで確認します。それ以外はすべてダッシュボードで行います。トピックファイルにその旨が記載されています。
• ユーザーがアプリケーションの計装を求めている場合は、traceway-setup スキルを使用します。

基本概念

• Organization は、メンバー、プロジェクト、ダッシュボード、オンコール、ステータスページを管理します。Project は 1 つのアプリケーションを表し、ほとんどのページはプロジェクト単位です。トレースは、同じ組織内の複数のプロジェクトをまたぐ場合があります。
• ロール：owner、admin、user、readonly があり、user と readonly のメンバーにはプロジェクトごとの権限設定もあります。
• 時間範囲：すべてのテレメトリページには、URL に保持される範囲が設定されています（?preset=24h、または ?from=&to=）。プリセットは 5m、30m、60m、3h、6h、12h、24h、3d、7d、1M、3M です。CLI と MCP でデータを読み取る場合は、--since または --from/--to を指定します。
• スパンが基本要素です。 エンドポイント、タスク、AI トレース、イシューは、取り込み時に昇格したスパンです。1 つの trace id が、リクエストを下流の呼び出し、ログ、例外と関連付けます。
• アラート、ページ、インシデントは、それぞれ異なるものです。アラートは通知を送信するルールです。ページは、誰かが確認するまで継続するオンコールのエスカレーションです。インシデントは、監視対象がダウンしていた期間（または手動で記録した期間）で、ステータスページに公開する説明を付けることもできます。

トピック

トピック	ファイル	MCP リソース	内容
イシュー	issues.md	traceway://knowledge/learn/issues	例外、フィンガープリント、イシューページと発生ページ、アーカイブ、リグレッション
エンドポイントとタスク	endpoints-and-tasks.md	traceway://knowledge/learn/endpoints-and-tasks	P50、P95、P99、影響スコア、Apdex、期待パフォーマンスのマーク、リクエスト、バックグラウンドタスク
スパン、トレース、ログ	traces-and-logs.md	traceway://knowledge/learn/traces-and-logs	スパンエクスプローラー、トレース全体のウォーターフォール、分散トレース、ログ検索、ライブテール
メトリクスとダッシュボード	metrics-and-dashboards.md	traceway://knowledge/learn/metrics-and-dashboards	メトリクス名とタグ、集計とレート、ダッシュボード、ウィジェット、テンプレート、お気に入り登録
セッション、AI トレース、プロファイル	sessions-and-ai.md	traceway://knowledge/learn/sessions-and-ai	セッションリプレイ、LLM 呼び出し、会話、フラグ付きコンテンツ、フレームグラフ
モニターとステータスページ	monitors.md	traceway://knowledge/learn/monitors	HTTP、TCP、ブラウザのチェック、実行、インシデント、公開ステータスページ、事後分析
アラート	alerts.md	traceway://knowledge/learn/alerts	各種ルールと設定、チャネル、クールダウン、一時停止、履歴
オンコール	on-call.md	traceway://knowledge/learn/on-call	チーム、スケジュール、レイヤー、オーバーライド、エスカレーションポリシー、ページ、連絡方法
組織とアクセス	organization.md	traceway://knowledge/learn/organization	プロジェクト、ロール、ホームページ、組織ビュー、Connection、Account、Settings、エージェントアクセス

ページマップ

ページ	パス	トピック
ダッシュボード（ホーム）	/	organization.md
イシュー	/issues, /issues/<hash>	issues.md
ログ	/logs	traces-and-logs.md
エンドポイント	/endpoints, /endpoints/<endpoint>	endpoints-and-tasks.md
タスク	/tasks	endpoints-and-tasks.md
スパン	/spans, /spans/<traceId>	traces-and-logs.md
プロファイル	/profiles	sessions-and-ai.md
セッション	/sessions（ブラウザおよびモバイルプロジェクト）	sessions-and-ai.md
AI トレース	/ai-traces	sessions-and-ai.md
ダッシュボード	/dashboards	metrics-and-dashboards.md
モニター	/monitors（タブ：Monitors、Status Pages、Post-Mortems）	monitors.md
公開ステータスページ	/status/<slug>	monitors.md
アラート	/notifications（タブ：Channels、Rules、History）	alerts.md
オンコール	/on-call（タブ：Pages、Overview、Teams、Schedules、Policies）	on-call.md
Connection	/connection	organization.md
Account	/account	organization.md, on-call.md
Settings	/settings（オーナーと管理者）	organization.md
Organization	/organization（Servers、Issues、Monitors、On-Call、Projects）	organization.md
プロジェクトのセットアップ	/setup	organization.md

ブラウザおよびモバイルプロジェクトでは、イシュー、セッション、アラート、オンコール、Connection のみが表示されます。

よくある質問

質問	回答
2つのエラーが同じ課題に記録されたのはなぜですか？ また、1つのエラーが2つに分割されたのはなぜですか？	issues.md, Fingerprinting
影響スコアとは何ですか？ また、このエンドポイントが Critical なのはなぜですか？	endpoints-and-tasks.md
ページを確認済みにするとどうなりますか？ 次に誰にページが送られますか？	on-call.md, Pages and Escalation policies
現在オンコールなのは誰ですか？ また、シフトを交代するにはどうすればよいですか？	on-call.md, Schedules and Overrides
うるさいアラートをスヌーズまたは無効にするには？	alerts.md, Disable versus snooze
1回の失敗でモニターがダウンになったのはなぜですか？ また、複数回失敗してもダウンにならないのはなぜですか？	monitors.md, States and runs
稼働時間を顧客に公開するにはどうすればよいですか？	monitors.md, Status pages
インシデントの記録はどこに書けばよいですか？	monitors.md, Post-mortems
ウォーターフォールからスパンが欠落しているのはなぜですか？	traces-and-logs.md
カウンターメトリクスの値が増える一方なのはなぜですか？	metrics-and-dashboards.md, Aggregations
エージェントは Traceway の設定を変更できますか？	organization.md, How agents get access