パイプライン監視

概要

HERE platform パイプラインは、時間の経過に伴うステータスの追跡に使用できる特定の標準的なメトリクスを生成します。 標準のメトリクスは 、 Logs 、 Monitoring 、 and Alerts ユーザー ガイドに一覧表示されます。 パイプラインのコードにカスタムメトリクスを挿入することもできます。 これらのメトリクスはすべてパイプラインステータスホームに表示 され、失敗したジョブなど、パイプラインジョブに関連付けられている特定のイベントのアラートを生成するために使用されます。

パイプラインステータスを監視します

パイプラインのステータスを監視するために、パイプラインステータスホームが Grafana で利用できます。 プラットフォームポータルで Launcher メニューを開き Primary monitoring and alerts 、を選択します（いいえ 図 1 の 1) 。 Grafana のホームページに移動します。

ホームページは次のようになります。

ホームページでは、複数のダッシュボードにアクセスできます。 ページの左側には、いくつかの既定のダッシュボードが一覧表示されています。 利用可能なユーザー定義アラートがページの右側に一覧表示されます。

デフォルトのダッシュボードのリストから 、パイプラインステータス ホームを探します。 ホーム名をクリックして開きます。

パイプラインステータスホームには、パイプラインジョブの次のステータスが表示されます。

• 失敗しました
• 完了しました
• キャンセル済み
• 送信済み
• 実行中です

各パイプラインステータスは色分けされ、すばやく識別できます。 ホームは、パイプラインステータスおよびパイプラインタイプ（ Flink または Spark ）でフィルタリングすることもできます。 詳細について は、「パイプラインステータスの定義」を参照してください。

パイプラインジョブ失敗アラートを設定します

1. 画面左上の Grafana ロゴをクリックします。 サイドメニューバーが開きます。

2. Alerting メニューバーでアイテムを探します。 Notification Channel 次に、 HERE のようにサブメニューでを探します。

   

3. [ 通知チャネル ] をクリックすると、画面が次の図のように変わります。

   

4. 「パイプライン失敗通知」という名前の通知チャネルを探します。 チャネル Edit のボタンをクリックして、通知チャネルの設定を変更します。

   

5. 表示されている HERE のように、障害アラートを受信するメールアドレスのリストを指定します。

   

6. アラートの変更をテストするに Send Test は、ボタンをクリックします。 これにより、アラートリストの各電子メールにテストメッセージが送信されます。

7. Save ボタンをクリックして、通知の変更を保存します。

これらの変更により、一覧表示されている電子メールアドレスは、パイプラインジョブが失敗したときにアラートを受信し始めます。 パイプラインステータスホームでアラートを確認することもできます。

ホームおよび障害アラートの制限事項

失敗した電子メールアラートの動作

失敗した電子メールは、アラート の状態 が変更された場合にのみ送信されます。 たとえば、パイプラインジョブが失敗すると、アラート はアラート状態になり 、失敗した電子メールが指定の受信者に送信されます。 デフォルトのアラート間隔である 1 分以内に別のパイプラインジョブが失敗した場合、 2 番目のメールは送信されません。 最初のアラート状態は、 1 分インターバルの終了時に「データなし」状態に移行する必要があります。この状態になると、後続の障害によってアラート電子メールがトリガーされます。 この動作により、次の 2 つの電子メールが送信されます。

• [ 警告 ]- 過去 1 分間に失敗したパイプラインジョブ ( 失敗したパイプラインジョブの詳細を含む ) 。 アラートが最初に報告されたときに送信されます。
• [ データなし ] - 過去 1 分以内に失敗したパイプラインジョブ ( 空の電子メール本文を含む ) 。 1 分インターバルの終了時に送信されました。

これは Grafana に固有の動作であり、 HERE platform の制限ではありません。 図 9 は、何が発生しているか、および故障 2 がどのように処理されていないかを示して

エラーログ

プラットフォームパイプラインには Debug、Warn、ErrorおよびInfo の 4 つのレベルのログを使用できます。 ログレベルは、プラットフォームポータル、 CLI 、または API を使用して設定できます。 または、のデフォルトのログレベルのみを使用でき warnます。

実行中のパイプラインジョブのログを確認するに は、 [View Jobs for a パイプライン Version] をクリックしてジョブ履歴を表示します。

次に 、トラブルシューティングを行うジョブの Logging URL ボタンをクリックします。 Splunk ホームが開き、選択したパイプラインバージョンのログが表示されます。

詳細については 、「パイプラインログ」を参照してください。

プラットフォームポータルからログレベルを設定します

さまざまな目的で、さまざまなレベルのログを使用できます。 HERE platform パイプラインでは、次のレベルのログ記録がサポートされています。

• デバッグ —パイプラインのトラブルシューティングに最も役立つ詳細情報イベントが含まれています。
• 情報 —大まかなレベルでパイプラインの進行状況を強調する情報メッセージが含まれます。
• 警告 —望ましくない、または予期せぬ、必ずしも「間違っている」ものではないその他の実行時の状況を含む、潜在的に有害な状況に関する情報が含まれます。 これがデフォルトのログレベルです。
• エラー —パイプラインの実行を継続できる可能性のある、その他のランタイムエラーまたは予期しない状況（エラーイベントなど）が含まれます。

プラットフォームポータルからログレベルを設定するには、パイプラインバージョンの詳細ページを使用します。 図 5 に例を示します。

ログ設定パネルの概要は、赤色の HERE で示されています。 このパイプラインの現在のログレベルが表示されます。 レベルを変更するには Edit 、ボタンをクリックします。 図 6 に示すダイアログボックスが表示されます。

ルートログレベルを変更するには、ダイアログボックス上部のドロップダウンリストを使用して、新しいログレベルを選択します。 図 7 に示すコントロールを使用して、追加のロガーを追加または削除できます。 これらのロガーのいずれかのロギングレベルを変更するには、示されているコントロールをクリックし、ドロップダウンリストから新しいレベルを選択します。

新しいロガーを追加すると、図 8 に示すように、ダイアログボックスが変更され、新しいロガーの情報を入力できるようになります。 ロガー名は通常 、リンク先のパイプラインコードのクラス名です。 ログレベルは必要に応じて設定でき、ルートログレベルと一致する必要はありません。

をクリック Add して、追加機能を閉じます。 次に、をクリック Saveして追加内容を保存します。

新しいロガーを追加するときに、すでに存在するロガーを選択すると、図 9 に示すようなエラーメッセージが表示されます。

図 10 に、新しいロガーを追加した結果と、そのロガーがパイプラインバージョン詳細ページにどのように表示されるかを示します。

も参照してください

• メトリクスとログユーザー ガイド
• Grafana ユーザードキュメント
• Splunk Enterprise 6.5.2 ユーザードキュメント