概要

注: このインテグレーションは 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

Returns CRITICAL if the Agent is unable to query the Neutron API, UNKNOWN if there is an issue with the Keystone API. Returns OK otherwise.

Statuses: ok, critical, unknown

openstack.nova.api.up

Returns CRITICAL if the Agent is unable to query the Nova API, UNKNOWN if there is an issue with the Keystone API. Returns OK otherwise.

Statuses: ok, critical, unknown

openstack.keystone.api.up

Returns CRITICAL if the Agent is unable to query the Keystone API. Returns OK otherwise.

Statuses: ok, critical

openstack.nova.hypervisor.up

Returns UNKNOWN if the Agent is unable to get the Hypervisor state, CRITICAL if the Hypervisor is down. Returns OK otherwise.

Statuses: ok, critical, unknown

openstack.neutron.network.up

Returns UNKNOWN if the Agent is unable to get the Network state, CRITICAL if the Network is down. Returns OK otherwise.

Statuses: ok, critical, unknown

トラブルシューティング

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

その他の参考資料

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

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