フリートに対する観測可能性の設定

ログとモニタリングは、 IBM Cloud® Code Engine における問題のトラブルシューティングに役立ち、ワークロードのパフォーマンスに関する洞察を提供します。 フリートに対するロギングとモニタリングの設定はプロジェクトレベルで行われ、他の Code Engine の機能とは異なります。

ロギングとモニタリングはオプションで、フリート作成後いつでも設定できる。

フリートのロギング設定

フリート用のログはプロジェクトレベルで設定される。 プロジェクトに対してこれらのセットアップ手順を実行すると、そのプロジェクト内のすべてのフリートでロギングが利用できるようになります。

1.既存のCloud Logsサービスインスタンスがあることを確認します

フリートが走る Code Engine プロジェクトのリージョンをターゲットとする Cloud Logs サービスインスタンスが必要です。 既存のCloud Logsサービスインスタンスを確認するには、UIの Logging routing ページに移動し、該当するリージョンを対象とするインスタンスを特定します。 リージョンにターゲットとなるロギングインスタンスがない場合は、UIプロンプトに従って設定します。

2.Cloud Logsインスタンスの権限を設定する

Cloud Logsインスタンスへのアクセスを割り当てるサービスIDとAPIキーがあることを確認し、必要な権限を設定します。

  1. サービス ID を作成します。 次に、 アカウント内のCloud Logsインスタンスをターゲットとする アクセス・ポリシーを サービスIDに割り当てます。 このアクセスポリシーに送信者サービスのアクセスレベルを割り当てます。
  2. サービスIDのAPIキーを作成する。 APIキーを安全な場所に保存し、後で参照できるようにする。

3.Cloud LogsインスタンスのプライベートIngressエンドポイントを取得する

Cloud LogsインスタンスのプライベートIngressエンドポイントを取得します。

  1. UIで ロギング・インスタンス・ページに移動し、該当するインスタンスをクリックする。
  2. [ エンドポイント ] をクリックします。
  3. プライベートIngressエンドポイントを見つける。 後で参照できるように、この値を安全な場所に保存してください。

4.ロギング・インスタンスに接続する仮想プライベート・エンドポイント・ゲートウェイを作成する

ロギング・インスタンスに接続する仮想プライベート・エンドポイント・ゲートウェイを作成する。 このVPEゲートウェイは、フリートが実行するVPC内に作成する必要があります。

  1. コンソールで VPEゲートウェイのページに移動する。
  2. 「作成」 をクリックします。
  3. Cloud Logsインスタンスが存在する場所と地域を選択します。
  4. あなたのフリートが走るVPCを選択してください。
  5. サービスをCloud Logsインスタンスに接続します。
    1. Request connection to a service セクションで、 IBM Cloud Serviceのオプションを選択します。
    2. クラウド・サービス・オファリング ]で [クラウド・ログ] を選択します。
    3. Cloud service regionsで、Cloud Logsインスタンスが存在するリージョンを選択します。
    4. 表から、関連するCloud Logsインスタンスを選択してVPEに接続します。
  6. 「作成」 をクリックします。

5.VPEゲートウェイに予約IPアドレスを作成する

VPEの各ゾーンについて、1つのサブネットに予約IPアドレスを追加する。

  1. コンソールで VPEゲートウェイのページに移動する。
  2. 前の手順で作成したVPEをクリックしてください。
  3. 「 添付リソースの管理 」をクリックします。
  4. 「 予約」または「IPの固定 」をクリックします。
  5. プロンプトに従って、VPEゾーンの1つのサブネットにIPアドレスを予約する。
  6. 各VPEゾーンの1つのサブネットについて、このプロセスを繰り返す。

6.フリートデフォルトのシークレットにロギング値を追加する

フリートデフォルトのシークレットに必要なロギング値を追加します。

  1. コンソールで、 Code Engine プロジェクトページに行き、フリートが走るプロジェクトを選択します。
  2. 「 Secrets」と「configmaps 」をクリックします。
  3. codeengine-fleet-defaults。
    1. 以前に作成されていない場合は、「 作成 」をクリックする。
    2. Generic secretを選択し、 Nextをクリックします。
    3. codeengine-fleet-defaults。 この名前と書式を正確に使用しなければならない。
  4. 以下の表に示すキーと値のペアを追加する。 なお、 logging_sender_api_key と logging_ingress_endpoint は先のステップで保存したものである。
艦隊のデフォルトシークレットのキーと値のペアを記録する。
キー 値
logging_ingress_endpoint Cloud LogsインスタンスのプライベートIngressエンドポイント。 この値は 前のステップで 保存されている。
logging_sender_api_key Cloud Logsインスタンスを対象とするサービスIDのAPIキー。 この値は 前のステップで 保存されている。
logging_ingress_port Cloud Logsインスタンスへの接続に使用されるポート。 プライベートVPEの場合は、 443 を指定してください。
logging_level_worker ワーカーログに含めたい詳細のレベル。 受け入れ可能なレベルは以下の通り： DEBUG INFO、 WARN、 ERROR。 デフォルトレベル： WARN.
logging_level_agent フリートエージェントのログに含める詳細レベル。 受け入れ可能なレベルは以下の通り： DEBUG INFO、 WARN、 ERROR。 デフォルトレベル： WARN.

7.フリートログの表示

Code Engine プロジェクトのフリートに対してロギングが設定されたので、フリートログを見ることができます。 手順については、 フリート用のログとモニタリングデータの表示を 参照してください。

車両群の監視設定

フリートに対するモニタリングは、プロジェクト・レベルで設定される。 プロジェクトに対してこれらのセットアップステップを実行すると、そのプロジェクト内のすべてのフリートに対してモニタリングが可能になります。

1.既存のClouds Monitoringインスタンスがあることを確認してください

フリートが所属する Code Engine プロジェクトの同じリージョンに Cloud Monitoring インスタンスがある必要があります。 既存の Cloud Monitoring サービス・インスタンスをチェックするには、UI の Monitoring instances ページに移動し、該当する地域のインスタンスを特定します。 適切なインスタンスがない場合は、UIプロンプトに従ってインスタンスを作成してください。

2.監視エージェントキーの取得

モニタリング・インスタンスのエージェント・キーを見つける。

  1. UIの Monitoring instances ページに移動し、該当するインスタンスをクリックする。 インスタンスの詳細ページで、[ Actions ] > [ Manage key] をクリックし、ダッシュボードですべてのキーを表示するオプションをクリックします。
  2. ab1c2345-****-678d9efgh012 のような形式のエージェント・キーをクリックする。 次に、フルエージェントキーをコピーするオプションをクリックします。
  3. エージェント・キーは、後でアクセスできる安全な場所に保存してください。

3.モニタリング・インスタンスに接続する仮想プライベート・エンドポイント・ゲートウェイを作成する

モニタリング・インスタンスに接続する仮想プライベート・エンドポイント・ゲートウェイを作成する。 このVPEゲートウェイは、フリートが実行するVPC内に作成する必要があります。

  1. コンソールで VPEゲートウェイのページに移動する。
  2. 「作成」 をクリックします。
  3. Cloud Monitoring インスタンスが存在する場所と地域を選択してください。
  4. あなたのフリートが走るVPCを選択してください。
  5. このサービスを Cloud Monitoring インスタンスに接続してください。
    1. Request connection to a service セクションで、 IBM Cloud Serviceのオプションを選択します。
    2. **クラウド・サービス・オファリングで **Cloud Monitoring.
    3. Cloud service regions ] で、 Cloud Monitoring インスタンスが存在するリージョンを選択します。
    4. 表から、該当する Cloud Monitoring インスタンスを選択して VPE に接続する。
  6. 「作成」 をクリックします。

4.VPEゲートウェイに予約IPアドレスを作成する

VPEの各ゾーンについて、1つのサブネットに予約IPアドレスを追加する。

  1. コンソールで VPEゲートウェイのページに移動する。
  2. 前の手順で作成したVPEをクリックしてください。
  3. 「 添付リソースの管理 」をクリックします。
  4. 「 予約」または「IPの固定 」をクリックします。
  5. プロンプトに従って、VPEゾーンの1つのサブネットにIPアドレスを予約する。
  6. 各VPEゾーンの1つのサブネットについて、このプロセスを繰り返す。

5.フリートデフォルトのシークレットにモニタリング値を追加

  1. コンソールで、 Code Engine プロジェクトページに行き、フリートが走るプロジェクトを選択します。
  2. 「 Secrets」と「configmaps 」をクリックします。
  3. codeengine-fleet-defaults。
    1. 以前に作成されていない場合は、「 作成 」をクリックする。
    2. Generic secretを選択し、 Nextをクリックします。
    3. codeengine-fleet-defaults。 この名前と書式を正確に使用しなければならない。
  4. 以下の表に示すキーと値のペアを追加する。 なお、 monitoring_ingestion_key は以前のステップで保存したものである。
艦隊のデフォルトシークレットのキーと値のペアを記録する。
キー 値
monitoring_ingestion_region Cloud Monitoring インスタンスが存在するリージョン。 例： au-syd.
monitoring_ingestion_key モニタリング・エージェントのキー。 この値は 前のステップで 求めたものである。

6.モニタリングダッシュボードでフリートデータを見る

Code Engine プロジェクトのフリートに対してモニタリングが設定されたので、フリートモニタリングデータを見ることができます。 手順については、 フリート用のログとモニタリングデータの表示を 参照してください。