Enterprise Server 3.20 は、現在リリース候補として使用できます。

Grafana を使用して OpenTelemetry メトリックを分析する

OpenTelemetry メトリック スタックによって提供されるダッシュボードとメトリックを使用して、インスタンスの正常性とパフォーマンスを監視します。

この記事で

[前提条件]

インスタンスで OpenTelemetry メトリックを有効にする必要があります。 構成手順については、 インスタンスの OpenTelemetry の構成 を参照してください。

  1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅にある をクリックします。
  2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。1. [ Site admin] サイドバーで、[[Management Console]] をクリックします。1. 複数の [Management Console] ユーザー アカウントを作成している場合は、 [ルート サイト管理者] または [[Management Console] ユーザー] を選びます。 [Management Console] のユーザー アカウントの詳細については、「管理コンソールへのアクセスの管理」を参照してください。
  3. [Management Console]の資格情報を入力します。 Continue をクリックします。
  4. [ モニター ] タブをクリックします。

メトリック ラベル

OpenTelemetry スタック エクスポーターは、メトリックにラベルを自動的にアタッチします。 一般的なラベルは次のとおりです。

  •         `job` — メトリックを生成したエクスポーターの名前

  •         `instance` — メトリックの送信元のインスタンス名

一部のエクスポーター ( node_exporter や haproxy_exporterなど) では、 job ラベルの値を検索することで、オープンソースドキュメントを使用できます。

ラベルの可用性は、エクスポーターとメトリックによって異なります。 一部のGitHubアプリケーション レベルのメトリックでは、インフラストラクチャ/エクスポーター メトリックよりも少ないラベルが提供される場合があり、ラベルはバージョンによって変更される可能性があります。

パネルクエリの確認

重要

事前構築済みのダッシュボードを開いて検査用に編集することはできますが、変更を保存することはできません。 カスタマイズを適用して保持するダッシュボードのコピーを作成します。

特定のパネルでどのメトリックとクエリが機能するかを理解するには、Grafana ダッシュボードを表示するときにグラフ パネル メニュー (3 つの垂直ドット) を使用します。

  •         **編集**:パネルエディタを開きます。 これは、視覚化を行うクエリを確認および調整するための最も直接的な方法です。  

  •         **探索**: パネルのクエリが事前に設定された状態で Grafana Explore を開き、対話型分析が可能になります。  

  •         **メトリックのドリルダウン**: 関連するメトリックを検出し、メトリックをラベル値別に分割するためのサイド パネルが開きます。

Grafana でのメトリックの探索

Grafana には、インスタンスで使用可能なメトリックを検出して分析するための複数の方法が用意されています。

Grafana のドリルダウン

Grafana Drilldown には、メトリック プレフィックス、ラベル、ラベルの値をフィルター処理してメトリックを検出するためのガイド付きワークフローが用意されています。 メトリックを選択すると、Grafana は使用可能なラベル値によって系列を分割できます。 たとえば、 haproxy_backend_response_errors_total はプロキシ/バックエンド ラベルの値でグループ化できます。

Grafana エクスプローラー

Grafana Explore を使用すると、PromQL (Prometheus クエリ言語) を使用した対話型分析が可能になります。これには、ユーザーが使用可能なメトリックとラベルを検出するのに役立つクエリ ビルダーが含まれます。

Grafana Explore での作業に関するヒント:

  •         **コード モードのメトリック ブラウザーを**使用して、メトリックとラベルを検出します。 ラベルとラベルの値を選択すると、関連付けられたメトリックが表示され、メトリックを選択すると、関連するラベルとラベルの値が表示されます。
  • メトリックを選択したら、 ビルダー モード に切り替えて、クエリを絞り込む提案を表示します。
  • [操作を追加] ボタンを使用すると、追加の 操作に アクセスできます。
  •         **オプション** パネルの **凡例** 設定を使用して、`false`ラベルをカスタマイズします。例として、****。 既定では、Grafana は一意のラベル セットに基づいて凡例ラベルを割り当てます。

詳細については、次を参照してください。

  •         [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/opentelemetry-metrics/advanced-dashboards)

  •         [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-the-monitor-dashboards#creating-new-dashboards)
  • Grafana ドキュメントの探索に着手する
  •         [Promql -](https://prometheus.io/docs/prometheus/latest/querying/basics/) Prometheus ドキュメントのクエリの基本