概要

注: このインテグレーションは OpenStack v12 以下に限定されます。OpenStack v13 以上からメトリクスを収集する場合は、OpenStack Controller インテグレーションを使用してください。

OpenStack サービスからメトリクスをリアルタイムに取得して、以下のことができます。

• OpenStack の状態を視覚化および監視できます。
• OpenStack のフェイルオーバーとイベントの通知を受けることができます。

セットアップ

インストール

OpenStack メトリクスをキャプチャするには、ハイパーバイザーを実行しているホストに Agent をインストールします。

構成

OpenStack の準備

ID サーバーで Datadog のロールとユーザーを構成します。

openstack role create datadog_monitoring
openstack user create datadog \
    --password my_password \
    --project my_project_name
openstack role add datadog_monitoring \
    --project my_project_name \
    --user datadog

次に、policy.json ファイルを更新して、必要なアクセス許可を付与します。role:datadog_monitoring には次の操作へのアクセスが必要です。

Nova

{
  "compute_extension": "aggregates",
  "compute_extension": "hypervisors",
  "compute_extension": "server_diagnostics",
  "compute_extension": "v3:os-hypervisors",
  "compute_extension": "v3:os-server-diagnostics",
  "compute_extension": "availability_zone:detail",
  "compute_extension": "v3:availability_zone:detail",
  "compute_extension": "used_limits_for_admin",
  "os_compute_api:os-aggregates:index": "rule:admin_api or role:datadog_monitoring",
  "os_compute_api:os-aggregates:show": "rule:admin_api or role:datadog_monitoring",
  "os_compute_api:os-hypervisors": "rule:admin_api or role:datadog_monitoring",
  "os_compute_api:os-server-diagnostics": "rule:admin_api or role:datadog_monitoring",
  "os_compute_api:os-used-limits": "rule:admin_api or role:datadog_monitoring"
}

Neutron

{
  "get_network": "rule:admin_or_owner or rule:shared or rule:external or rule:context_is_advsvc or role:datadog_monitoring"
}

Keystone

{
  "identity:get_project": "rule:admin_required or project_id:%(target.project.id)s or role:datadog_monitoring",
  "identity:list_projects": "rule:admin_required or role:datadog_monitoring"
}

ポリシーの変更を有効にするには、Keystone、Neutron、および Nova API サービスを再起動する必要があります。

注: OpenStack インテグレーションをインストールすると、Datadog が監視する VM 数が増える可能性があります。これが課金にどのように影響するかについては、課金に関する FAQ を参照してください。

Agent の構成

1. Datadog Agent が Keystone サーバーに接続するように構成し、監視するプロジェクトを個別に指定します。以下の構成で Agent の構成ディレクトリのルートにある conf.d/ フォルダーの openstack.d/conf.yaml ファイルを編集します。使用可能なすべての構成オプションの詳細については、サンプル openstack.d/conf.yaml を参照してください。

   init_config:
     ## @param keystone_server_url - string - required
     ## Where your identity server lives.
     ## Note that the server must support Identity API v3
     #
     keystone_server_url: "https://<KEYSTONE_SERVER_ENDPOINT>:<PORT>/"
   
   instances:
     ## @param name - string - required
     ## Unique identifier for this instance.
     #
     - name: "<INSTANCE_NAME>"
   
       ## @param user - object - required
       ## User credentials
       ## Password authentication is the only auth method supported.
       ## `user` object expects the parameter `username`, `password`,
       ## and `user.domain.id`.
       ##
       ## `user` should resolve to a structure like:
       ##
       ##  {'password': '<PASSWORD>', 'name': '<USERNAME>', 'domain': {'id': '<DOMAINE_ID>'}}
       #
       user:
         password: "<PASSWORD>"
         name: datadog
         domain:
           id: "<DOMAINE_ID>"
   

2. Agent を再起動します。

ログ収集

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml でこれを有効にできます。

   logs_enabled: true
   

2. Openstack ログの収集を開始するには、次のコンフィギュレーションブロックを openstack.d/conf.yaml ファイルに追加します。

   logs:
     - type: file
       path: "<LOG_FILE_PATH>"
       source: openstack
   

   path パラメーターの値を変更し、環境に合わせて構成します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル openstack.d/conf.yaml を参照してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで openstack を探します。

収集データ

メトリクス

イベント

OpenStack チェックには、イベントは含まれません。

サービスチェック

openstack.neutron.api.up
Agent が Neutron API をクエリできない場合は CRITICAL を、Keystone API に問題がある場合は UNKNOWN を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル, 不明

openstack.nova.api.up
Agent が Nova API をクエリできない場合は CRITICAL を、Keystone API に問題がある場合は UNKNOWN を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル, 不明

openstack.keystone.api.up
Agent が Keystone API をクエリできない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル

openstack.nova.hypervisor.up
Agent がハイパーバイザーの状態を取得できない場合は UNKNOWN、ハイパーバイザーがダウンしている場合は CRITICAL を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル, 不明

openstack.neutron.network.up
Agent がネットワークの状態を取得できない場合は UNKNOWN、ネットワークがダウンしている場合は CRITICAL を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル, 不明

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

• OpenStack Nova の監視
• 開発/テスト用の 2 つのコマンドを使用した OpenStack のインストール
• OpenStack: ホストアグリゲート、フレーバー、アベイラビリティーゾーン