IBM Cloud Docs
Code Engineをモニターするカスタム・ダッシュボードの作成

Code Engineをモニターするカスタム・ダッシュボードの作成

IBM Cloud Monitoring を使用して、Code Engineワークロードの正常性とパフォーマンスを可視化します。 Code Engineワークロード用にMonitoringダッシュボードをカスタマイズして、調整された一連のメトリックにすることで、ボトルネックを特定したり、発生する可能性のある生産問題を予測したりできます。

Code Engineをモニターするカスタム・ダッシュボードの作成

調整した一連のメトリックに合わせて、Code Engineワークロード用のカスタムMonitoringダッシュボードを作成できます。

Monitoringでカスタム・ダッシュボードを作成するには、まずCode Engineワークロードのモニターをセットアップしなければなりません。 Monitoringサービス・インスタンスをセットアップし、モニター対象のCode Engineプロジェクトと同じリージョンでプラットフォーム・メトリックを有効にします。 複数のリージョンにデプロイメントが存在する場合は、リージョンごとに Monitoring をプロビジョンしてプラットフォーム・メトリックを有効にする必要があります。 IBM Cloud Monitoringサービス・インスタンスのセットアップ、およびCode EngineワークロードをモニターするためのIBM Cloud Monitoringメトリック・ダッシュボードへのアクセスについて詳しくは、Code Engineのモニターを参照してください。

Code EngineにはIBM Code Engine Project Overviewダッシュボードが用意されています。このダッシュボードは、Code Engineワークロードのさまざまな側面をモニターする事前定義パネルで構成されています。 Code Engineワークロード用のカスタム Monitoringダッシュボードを、調整した一連のメトリックに作成できます。

  1. IBM Cloud Monitoring サービス・インスタンスをセットアップします。 アクティブな IBM Cloud Monitoring インスタンスを確認するには、「プログラム識別情報」ダッシュボードを参照してください。

  2. 使用可能なモニター・データがあることを確認してください。 モニターするデータがあるとカスタム・ダッシュボードの設計が容易になるため、アプリケーションまたはジョブを実行することが重要です。 一部のCode Engineメトリックは、環境内で使用可能な場合にのみ存在します。

  3. Code Engineに使用可能なメトリックを確認します。

  4. IBM Cloud Monitoringメトリックにアクセスします。

    1. IBM Cloud ナビゲーション・メニューの**「プログラム識別情報」**を選択します。
    2. **「モニタリング」**を選択します。
    3. ダッシュボードを開くをクリックして、モニター・インスタンスのダッシュボードを開きます。
    4. ナビゲーション・メニューから、「ダッシュボード->IBM->IBM Code Engineプロジェクトの概要」を選択します。 メニューに Code Engine ダッシュボードが表示されない場合は、**「モニタリングの起動」**を選択して、Code Engine アプリケーションまたはジョブからモニタリングを開始できます。
  5. カスタム・ダッシュボードの作成をクリックして、IBM Code Engine Project Overviewダッシュボードのコピーを作成します。 カスタム・ダッシュボードの名前を入力し、作成して開くをクリックします。 例えば、ダッシュボードにMy custom IBM Code Engine Project Overviewという名前を付けます。

  6. ダッシュボード・パネルを追加または削除して、ダッシュボードをカスタマイズします。 Code Engineアプリケーションおよびジョブ実行のワークロードをモニターするためにダッシュボードをカスタマイズする方法の例については、シナリオ 1および シナリオ 2を参照してください。 IBM Cloud Monitoringダッシュボードの操作について詳しくは、ダッシュボードの操作を参照してください。

    ダッシュボードのレイアウトを変更する場合は、必ずレイアウトの保存をクリックして変更を保存してください。 ダッシュボードのカスタマイズを続行する前に、レイアウトの変更を保存するか、キャンセルしなければなりません。

  7. カスタム・ダッシュボードを保存します。 カスタム・ダッシュボードは、ダッシュボードのナビゲーション・メニューダッシュボード-> マイ・ダッシュボードで使用できます。

シナリオ 1: Code Engineアプリケーション・インスタンスおよびジョブ実行に焦点を絞る

Code Engineワークロードのモニター範囲を絞り込み、実行中のアプリケーションおよびジョブ実行のインスタンスに焦点を合わせます。 この情報をモニターすると便利な場合があります。アプリケーションがゼロにスケーリングされる場合や、ジョブまたはビルドが実行されていない場合は、リソースが消費されないためです。 このシナリオでは、既存のIBM Code Engine Project Overview ダッシュボードから以前に作成したMy custom IBM Code Engine Project Overviewダッシュボードを使用し、パネルを変更および削除することでカスタム・ダッシュボードを単純化します。

  1. カスタム・ダッシュボードを開きます。 このシナリオでは、IBM Code Engine Project Overviewダッシュボードのコピーから開始することを想定しています。 カスタム・ダッシュボードは、ダッシュボードのナビゲーション・メニューダッシュボード-> マイ・ダッシュボードで使用できます。

  2. Total number of Applications数値パネルを変更し、ibm_codeengine_application_actual_instancesメトリックを使用して実際のインスタンス数を表示するように照会を変更します。

    1. パネルを編集するには、鉛筆アイコンをクリックします。
    2. 照会タブで、ibm_codeengine_application_service_countメトリックをクリックして、メトリックを変更します。 Code Engineメトリックのリストを表示するには、ibm_codeengine_ と入力します。 この例では、 ibm_codeengine_application_actual_instancesメトリックを選択し、 Maximum時間集約とMaximumグループ・ロールアップを指定します。
    3. 「パネル」タブで、このパネルの名前をTotal number of Application Instancesに変更します。
    4. 保存 をクリックして、このパネルの変更を保存します。
  3. ibm_codeengine_jobrunsメトリックを使用して、Total number of Application revisions数値パネルを変更し、ジョブ実行の数を表示するように照会を変更します。

    1. パネルを編集するには、鉛筆アイコンをクリックします。
    2. 照会タブで、ibm_codeengine_application_revision_countメトリックをクリックして、メトリックを変更します。 Code Engineメトリックのリストを表示するには、ibm_codeengine_ と入力します。 この例では、 ibm_codeengine_jobrunsメトリックを選択し、 Maximum時間集約とMaximumグループ・ロールアップを指定します。
    3. 「パネル」タブで、このパネルの名前をTotal number of Job Runsに変更します。
    4. 保存 をクリックして、このパネルの変更を保存します。
  4. アクション・メニューを使用して、Total number of Application routes番号パネルを削除します。

  5. ibm_codeengine_application_actual_instancesメトリックおよびibm_codeengine_jobrunsメトリックを使用して、 Applications overviewタイム・チャート・パネルを変更し、アプリケーションおよびジョブ実行インスタンスに関するモニター情報を表示するように照会を変更します。

    1. パネルを編集するには、鉛筆アイコンをクリックします。
    2. 「照会」タブで、ibm_codeengine_application_actual_instancesメトリックを保持し、それらのメトリックのアクション・メニューを使用してメトメックの他の行を削除します。
    3. 「照会」タブで、ibm_codeengine_application_actual_instancesメトリックを見つけ、アプリケーション・リビジョン情報を含むようにセグメンテーションを変更します。 ibm_codeengine_application_nameをクリックし、ibm_codeengine_revision_nameを追加します。 Apply to All Queriesの選択をクリアしたことを確認します。
    4. 「照会」タブで、照会の追加をクリックして、ジョブ実行の照会を追加します。 メトリック・フィールドに、Code Engineメトリックのリストを示すibm_codeengine_を入力します。 ibm_codeengine_jobrunsメトリックを選択し、Maximum時間集約とMaximumグループ・ロールアップを指定します。 このメトリックの ibm_codeengine_jobrun_conditionセグメンテーションを指定します。
    5. このパネルのibm_codeengine_application_actual_instancesおよびibm_codeengine_jobrunsメトリックのみを設定していることを確認してください。
    6. 「パネル」タブで、このパネルの名前をApplication and Job Run Instancesに変更します。
    7. 保存をクリックして、このパネルの変更を保存します。
  6. このシナリオの前のステップで更新されたパネルを保持しますが、アクション・メニューを使用して他のパネルを削除します。 不要なパネルを削除した後、必要に応じて個々のパネルのサイズとレイアウトを調整できます。

    ダッシュボードのレイアウトを変更する場合は、必ずレイアウトの保存をクリックして変更を保存してください。 ダッシュボードの変更を続行する前に、レイアウトの変更を保存するか、キャンセルしなければなりません。

シナリオ 1 を完了すると、カスタム・ダッシュボードにTotal number of Application InstancesTotal number of Job Runs、およびApplication and Job Run Instancesの 3 つのパネルが組み込まれます。

シナリオ 2: Code Engineワークロードでの PromQL 照会の使用

シナリオ 1 で作成したカスタム・ダッシュボードから、IBM Cloud MonitoringのPrometheus照会言語 (PromQL) 照会機能を使用して、アプリケーションとジョブ実行のメトリックの数を 1 つのパネルに集約したいと仮定します。 このシナリオでは、PromQL を使用して、アプリケーション・インスタンスの数とジョブ実行の数を単一の数値パネルに追加します。

  1. シナリオ 1 でカスタマイズしたカスタム・ダッシュボードを開きます。 カスタム・ダッシュボードは、ダッシュボードのナビゲーション・メニューダッシュボード-> マイ・ダッシュボードで使用できます。

  2. Total number of Applicationsの数値パネルを変更し、アプリケーション・インスタンスの数とジョブ実行の数を合計するように照会を変更します。

    1. パネルを編集するには、鉛筆アイコンをクリックします。
    2. 「照会」タブで、PromQLをクリックして PromQL 照会を使用します。
    3. 「照会」タブで、照会の内容をsum(max(ibm_codeengine_application_actual_instances) + max(ibm_codeengine_jobruns))に置き換えます。 numberを単位として使用するように オプション を更新します。 **「照会の実行 (Run query)」**をクリックします。
    4. 「パネル」タブで、このパネルの名前をTotal number of Application instances and Job Runsに変更します。
    5. 保存 をクリックして、このパネルの変更を保存します。
  3. 「アクション」メニューを使用してTotal number of Job Runs番号パネルを削除します。これは、前のステップでアプリケーションの総数とジョブの実行の両方を単一の番号パネルに集約したためです。

  4. 必要に応じて、個々のパネルのサイズとレイアウトを調整できます。

    ダッシュボードのレイアウトを変更する場合は、必ずレイアウトの保存をクリックして変更を保存してください。 ダッシュボードのカスタマイズを続行する前に、レイアウトの変更を保存するか、キャンセルしなければなりません。

シナリオ 2 を完了すると、カスタム・ダッシュボードにTotal number of Application instances and Job RunsApplication and Job Run Instancesの 2 つのパネルが組み込まれます。