YouTrack クラウド 2026.2 ヘルプ

YouTrack のパフォーマンスを監視する

YouTrack は、サイトの負荷と健全性を監視するのに役立つパフォーマンス指標を提供します。継続的な監視により、これらの指標の変化を検知し、ユーザーに影響が出る前に異常な動作を調査できます。課題が発生した場合でも、指標の履歴を示すグラフは、JetBrains サポートが課題をトラブルシューティングし、動作が変化した時期を特定できます。

現在の状況を把握したい場合はユーザーインターフェースでメトリクスを表示できます。また、メトリクス値を時系列で保存したい場合は、REST API を使用してプログラムでテレメトリデータを収集できます。

REST API を使用してメトリクスを収集する

監視ツールやスクリプトで YouTrack をポーリングし、メトリクス値を時系列で保存する場合は、REST API を使用してください。テレメトリエンドポイントは JSON 形式でデータを返し、要求したフィールドのみが含まれます。

リソースパスは /api/admin/telemetry です。返される属性のリストは、YouTrack Server を使用するか YouTrack Cloud を使用するかによって異なります。お使いのエディションでサポートされていない属性については、YouTrack は null を返します。

REST API を使用してパフォーマンス指標を収集するには:

  1. 低レベルの管理者読み取り権限を持つユーザーアカウント用の永久トークンを生成します。

  2. 収集したいテレメトリフィールドを選択してください。パフォーマンス監視によく使用されるフィールドには、databaseSizefullDatabaseSizetextIndexSizerequestsPerSecondtransactionsPerSecondpendingAsyncJobsonlineUsers(users)uptimestartedTime などがあります。

  3. fields クエリパラメーターに選択したフィールドを、Authorization ヘッダーにトークンを含めて、<youtrack-base-url>/api/admin/telemetryGET リクエストを送信します。

  4. 監視ツールを設定して、監視ニーズに合ったスケジュールでリクエストを繰り返すようにしてください。

example を、ご使用の YouTrack サイトのサブドメインに置き換えてください。ベース URL が異なるクラウドサイトの場合は、YouTrack サイトを開く完全な URL を使用してください。

curl -X GET \ 'https://example.youtrack.cloud/api/admin/telemetry?fields=databaseSize,uptime,startedTime,textIndexSize,onlineUsers(users)' \ -H 'Authorization: Bearer <permanent-token>' \ -H 'Accept: application/json'

リクエストが成功すると、要求されたフィールドを含む JSON オブジェクトが返されます。

{ "startedTime": 1610613083628, "databaseSize": "5.0 MB", "textIndexSize": "0.1 MB", "uptime": "644 hours, 19 minutes, 10 seconds and 121 milliseconds", "onlineUsers": { "users": 12, "$type": "OnlineUsers" }, "$type": "Telemetry" }

テレメトリフィールドとそのデータ型の完全なリストについては、テレメトリデータの REST API リファレンスを参照してください。

ユーザーインターフェースからメトリクスを収集する

サーバーメトリクスページは、たとえばサイトの応答速度が遅い場合のトラブルシューティングや、サポート依頼のための情報収集など、現在の値を手動で確認する必要がある場合に使用します。

YouTrack のパフォーマンス指標を表示するには:

  1. 管理メニューを開き、サーバー設定> グローバル設定を選択します。

  2. サーバー構成タブの一番下までスクロールしてください。

  3. サーバーメトリクスセクションで、サーバーメトリクスを表示するをクリックします。

  4. サーバーメトリクスページの値を確認し、調査に関連する指標を記録してください。

このページに表示される指標の詳細については、サーバーメトリクスを参照してください。

2026 年 7 月 27 日