개요

참고: 이 통합은 OpenStack v12 이하에만 적용됩니다. OpenStack v13 이상에서 메트릭을 수집하려면 OpenStack Controller 통합을 사용합니다.

OpenStack 서비스에서 실시간으로 메트릭을 받아 다음을 수행할 수 있습니다.

• OpenStack 상태를 시각화 및 모니터링합니다.
• OpenStack 실패 복구 및 이벤트에 대한 알림을 받습니다.

설정

설치

OpenStack 메트릭을 캡처하려면 에이전트를 설치합니다 on your hosts running hypervisors.

설정

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을 참조하세요.

에이전트 설정

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 에이전트에서는 로그 수집이 기본적으로 비활성화되어 있습니다. 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의 상태 명령을 실행하고 점검 섹션 아래에서 openstack을 찾습니다.

수집한 데이터

Metrics

이벤트

OpenStack 점검은 이벤트를 포함하지 않습니다.

서비스 점검

openstack.neutron.api.up

Agent가 Neutron API에 쿼리할 수 없는 경우 CRITICAL이 반환됩니다. Keystone API에 문제가 있는 경우 UNKNOWN이 반환되며, 그 외 경우에는 OK가 반환됩니다.

상태: ok, critical, unknown

openstack.nova.api.up

Agent가 Nova API에 쿼리할 수 없는 경우 CRITICAL이 반환됩니다. Keystone API에 문제가 있는 경우 이 반환되며, 그 외 경우에는 OK가 반환됩니다.

상태: ok, critical, unknown

openstack.keystone.api.up

Agent가 Keystone API에 쿼리할 수 없는 경우 CRITICAL이 반환되며, 그 외 경우에는 OK가 반환됩니다.

상태: ok, critical

openstack.nova.hypervisor.up

Agent가 하이퍼바이저 상태를 가져올 수 없는 경우 UNKNOWN이 반환됩니다. 하이퍼바이저가 중단된 경우 CRITICAL이 반환되며 그 외의 경우에는 OK가 반환됩니다.

상태: ok, critical, unknown

openstack.neutron.network.up

Agent가 네트워크 상태를 가져올 수 없는 경우 UNKNOWN이 반환됩니다. 네트워크가 중단된 경우 CRITICAL이 반환되며, 그 외의 경우에는 OK가 반환됩니다.

상태: ok, critical, unknown

트러블슈팅

도움이 필요하세요? Datadog 고객지원팀에 문의하세요.

참고 자료

기타 유용한 문서, 링크 및 기사:

• OpenStack Nova 모니터링
• 개발 및 테스트용 명령 2개로 OpenStack 설치
• OpenStack: 호스트 집계, 플레이버 및 가용 영역