メトリクスを監視します

HERE Workspace には、オープンソースのデータ視覚化および監視ツールである Grafana が含まれています。 Grafana を使用すると、カタログやパイプラインによって生成されたメトリクスを視覚化し、ダッシュボードやアラートを作成できます。

Grafana ダッシュボードにアクセスするには、ランチャメニューの [ プライマリリージョンの監視 ] または [ セカンダリリージョンの監視 ] をクリックします。

または、ランチャメニューを使用せずに、プライマリリージョンの監視とセカンダリリージョンの監視の両方に直接アクセスできます。プライマリリージョンは https://grafana.metrics.platform.here.com から、セカンダリリージョンは https://grafana.metrics.us-west-2.platform.here.com からアクセスできます。

各リージョンは 1 つの Grafana ホームによって監視されます。

注 : Grafana は単一リージョンです

複数リージョンのカタログの場合でも、選択したリージョンのメトリクスのみが表示されます。

Grafana に入ったら、左上にあるホームボタンをクリックして、メトリックダッシュボードを表示します。

データソース

パネルを作成または編集する場合、「プライマリ」データソースがデフォルトで選択され、「デフォルト」のデータソースと同じになります。他のデータソースの使用は推奨されていません。

メトリクスとラベル

メトリクスとラベル は、すべての時間帯データを保存するために使用されるデータモデルの主要な概念です。

メトリックデータは、時系列として Prometheus に保存されます。時間帯とは、同じメトリックおよび同じラベル付き寸法のセットに属するタイムスタンプ値のストリームです。

注 : Grafana ダッシュボードを作成しています

Grafana でカスタムホームを作成する場合は、 Prometheus から PromQL マクロ言語を使用して特定のメトリクスを要求する必要があります。

Prometheus に保存されている時間帯は 、メトリック 名と 、ラベルと呼ばれるオプションのキーと値のペアによって一意に識別されます。メトリック名は、システムの測定済みの特性を示します。たとえば、 HERE Workspace では、組織 layer_total 内のすべてのカタログの既存のレイヤー数を表すという名前のメトリクスがあります。

ラベルを使用すると、データにさらに寸法を追加できます。たとえば、 layer_total layer_type=versioned ラベルと結合して、バージョン管理されたレイヤーのみをフィルタリングできます。この概念のもう 1 つの実用的な用途は、同じメトリックでレポートする複数のパイプラインのフィルタリングです。すべてのパイプラインが pipeline_jobs_failed メトリックを報告しており、関心のある特定のパイプライン ID の値を持つ pipelineId ラベルを使用して、対象のパイプラインのみをフィルタリングできます。

これらのクエリはすべて、ユーザーがリアルタイムで時間系列データを選択して集計できる PromQL (Prometheus Query Language) をベースにしています。

メートル法の名前と一連のラベルを指定 <metric name>{<label name>=<label value>, ...}すると、時間帯が頻繁に次の表記法で識別されます。

ラベルは任意で、新しいサービスまたはコンポーネントがそのラベルを送信したときにその場で利用できます。特定の期間における、ラベルとメトリックに関連付けられている値のリストを表示するには、 Grafana のエクスプローラ機能を使用します。

エクスプローラ 機能にアクセスするには、 Grafana の左側のツールバーにあるコンパスアイコンをクリックします。

ドロップダウンメニューで [Metrics]を選択し、メトリックの名前を入力します（例：layer_total{}）。中括弧の間にカーソルを置くと、選択した期間内にそのメトリックで使用可能なラベルのリストが表示されます。入力フィールドのオートコンプリート機能は、Ctrl + Spaceキーを押しても起動できます。

また、Grafanaブラウザを使用して、特定のメトリックのラベルを探索することもできます。最初にメトリックを選択し、次にラベルを選択し、最後にラベルの1つ以上の値を選択します。

HE クエリを実行すると、選択した期間のすべてのラベルとその値を含むテーブルが返されます。

クエリー変数

上記のメソッドに加えて、メートル法のクエリでハードコード値が使用されないようにするために、変数をその場所で使用できます。これらの変数は呼び出さ Query variable れ、メトリクス、ラベル、またはラベル値のリストを Prometheus にクエリできます。

[ クエリ ] 入力フィールドでは、次の関数を使用できます。

名前	説明
`label_names()`	ラベル名のリストを返します。
~~label_values ( ラベル )~~ ( 廃止予定 )	~~すべてのメトリックのラベルのラベル値のリストを返します。~~
`label_values(metric, label)`	指定したメトリックのラベルのラベル値のリストを返します。
`metrics(metric)`	指定したメトリックの正規表現に一致するメトリックのリストを返します。