IBM Cloud のモニタリング

Instana ホストエージェントをインストールすると、 IBM Cloud Platform Metricsセンサーが自動的にインストールされます。

ただし、 「設定 」のセクションに記載されている手順に従って、設定を完了する必要があります。 その後、 Instana のUIで、 IBM Cloud に関連するメトリクスを確認できます。

IBM Cloud 仮想サーバーへの Instana ホストエージェントのインストール

「 Instana 」バックエンドにアクセスできる「 IBM Cloud 」仮想サーバーに、「 Instana 」ホストエージェントをインストールできます。 Linux® オペレーティングシステム上で動作する IBM Cloud 仮想サーバーで、 Instana ホストエージェントを実行します。 たとえば、 B1.2x8 のインスタンスが最適です。

注: クラウド環境内で監視対象となるエンティティの数によっては、ホストエージェントが使用できるメモリの上限を増やす必要がある場合があります。 エージェントのメモリ容量を増やすには、環境 AGENT_MAX_MEM 変数をデフォルト値である 544 より大きい値に設定します。 MiB, たとえば、ホストエージェントのメモリを 1 GB に設定するには、次のように設定します AGENT_MAX_MEM=1024M

「 IBM Cloud 」アカウントと「 IBM Cloud 」リージョンの組み合わせごとに、「 Instana 」ホストエージェントは1つだけインストールしてください。 同じ「 IBM Cloud 」アカウントと「 IBM Cloud 」リージョンの組み合わせに対して複数の IBM Cloud エージェントをインストールすると、 IBM Cloud から追加料金が発生する可能性があります。ただし、 Instana を使用しても、監視の品質が向上するといったメリットはありません。

の構成

API キーの取得

  1. IBM Cloud Platformのメトリクスの収集を有効にします
  2. IBM Cloud ダッシュボードから、ナビゲーション・メニューを選択します。
  3. ドロップダウン・リストで、 「プログラム識別情報」を選択します。
  4. 「プログラム識別情報」ページから 「モニター」 を選択し、「ダッシュボードを開く」リンクを選択します。
  5. ダッシュボードで、ユーザーのイニシャルが付いた円アイコンを選択します。
  6. 設定 」を選択し、「設定」ページにある API トークンをコピーします。 コピーした API トークンが、あなたの API キーです。

ホストエージェントの設定

  1. ホストエージェントのファイル <agent_install_dir>/etc/instana/configuration.yaml 内で、「 IBM Cloud Platform Services」セクションを検索してください。

  2. 監視が必要な各 IBM Cloud の拠点について、 IBM Cloud Monitoring エンドポイントと API キーを設定します。 複数のロケーションを構成できます。

    # IBM Cloud Platform Services
    #com.instana.plugin.ibmcloud:
    #  enabled: true
    #  poll_rate: 60 #Values are in seconds. Default Value 60 Sec.
    #  locations: # Support multiple IBM Cloud locations. Add location configuration as follows.
    #    - location_endpoint: '<INSERT_ENDPOINT_HERE>' # IBM Cloud Monitoring endpoint. For example, https://us-south.monitoring.cloud.ibm.com
    #      apikey: '<INSERT_APIKEY_HERE>' # IBM Cloud Monitoring API Key for this location.
    #    - location_endpoint: '<INSERT_ENDPOINT_HERE>' # IBM Cloud Monitoring endpoint. For example, https://us-east.monitoring.cloud.ibm.com
    #      apikey: '<INSERT_APIKEY_HERE>' # IBM Cloud Monitoring API Key for this location.
    
注: ポーリング間隔が指定されていない場合、システムはサポートされる最小ポーリング間隔である60秒に設定します。

メトリックの表示

メトリックを表示するには、以下のステップを実行します。

  1. Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
  2. 特定のモニター対象ホストをクリックします。

これで、収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。

対応している指標

Instana のUIでは、以下の種類のメトリクスを表示できます:

  • IBM Cloudant
  • IBM Cloud Container Registry
  • IBM Cloud Databases for Elasticsearch
  • IBM Cloud Databases for etcd
  • IBM Cloud Databases for MongoDB
  • IBM Cloud Databases for PostgreSQL
  • IBM Cloud Messages for RabbitMQ
  • IBM Cloud Databases for Redis
  • IBM Cloud Functions
  • IBM Cloud Object Storage
  • IBM Cloud Schematics
  • IBM Cloud SQL Query
  • IBM Event Streams
  • IBM Cloud Load Balancer
  • IBM Load Balancer for VPC
  • IBM Cloud Virtual Servers
  • IBM VPC 仮想サーバー・インスタンス
  • IBM VPN for VPC

各タイプに関連する詳細なメトリクスについては、 IBM Cloud の「Platform Services Monitoring」 を参照してください。

正常性シグニチャー

各センサーには、着信メトリックに対して継続的に評価され、ユーザーの影響に応じて問題またはインシデントを発生させるために使用される、正常性シグネチャーのキュレーションされた知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

IBM Cloud Platform Metricsを Instana バックエンドに送信するエージェントによって、イベントが発生する場合があります。 可能なイベントについては、 組み込みイベントのリファレンスを参照してください。

モニタリングの問題

接続エラー

監視対象の種類: ibmcloud_invalid_apikey

IBM Cloud Platform Metricsセンサーが、無効な API キーのため、 IBM Cloud に接続できません。 ホストエージェントのファイル configuration.yaml に、有効な API キーが正しく設定されていることを確認してください。

監視対象の種類: ibmcloud_unknown_host

ホストが不明であるため、 IBM Cloud Platform Metrics センサーが IBM Cloud に接続できません。 ホスト・エージェントの configuration.yaml ファイルでホストが正しく構成されていることを確認してください。

監視対象の種類: ibmcloud_connection_error

IBM Cloud Platform Metricsセンサーが、無効な API キーや不明なホスト以外の理由で IBM Cloud に接続できません。 追加情報については、ホスト・エージェント・ログを参照してください。