Active Directory 도메인 서비스

AD DS(Active Directory 도메인 서비스)는 네트워크의 객체에 대한 정보를 저장하여 관리자와 사용자가 이 정보에 쉽게 액세스할 수 있도록 합니다.

AD DS에 대한 자세한 내용은 Active Directory 도메인 서비스(AD DS) 문서를 참조하세요.

기본 요건

AD DS 원격 분석을 수집하려면 작업 에이전트를 설치해야 합니다.

측정항목의 경우 버전 2.15.0 이상을 설치합니다.
로그에는 버전 2.15.0 이상을 설치합니다.

이 통합은 AD DS 버전 Windows Server 2012 R2, Windows Server 2016, Windows Server 2019를 지원합니다.

AD DS 인스턴스 구성

Active Directory Windows 이벤트 로그 및 성능 카운터는 기본적으로 사용 설정됩니다.

AD DS용 작업 에이전트 구성

작업 에이전트 구성 가이드에 따라 AD DS 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 AD DS의 원격 분석을 수집하여 처리하는 구성을 만들고 작업 에이전트를 다시 시작합니다.

# Create a back up of the existing file so existing configurations are not lost.
Copy-Item -Path 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' -Destination 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml.bak'

# Configure the Ops Agent.
Add-Content 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' "
logging:
  receivers:
    active_directory_ds:
      type: active_directory_ds
  service:
    pipelines:
      active_directory_ds:
        receivers:
        - active_directory_ds

metrics:
  receivers:
    active_directory_ds:
      type: active_directory_ds
  service:
    pipelines:
      active_directory_ds:
        receivers:
        - active_directory_ds
"

Stop-Service google-cloud-ops-agent -Force
Start-Service google-cloud-ops-agent*

로그 수집 구성

AD DS의 로그를 수집하려면 AD DS가 생성하는 로그에 대한 수신자를 만들고 새 수신자에 대한 파이프라인을 만들어야 합니다.

active_directory_ds 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`type`		값은 `active_directory_ds`여야 합니다.

로깅되는 내용

logName은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry 내의 자세한 필드는 다음과 같습니다.

active_directory_ds 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드	유형	설명
`jsonPayload.Channel`	문자열	로그가 기록된 이벤트 로그 채널입니다.
`jsonPayload.ComputerName`	문자열	이 로그가 시작된 컴퓨터의 이름입니다.
`jsonPayload.Data`	문자열	로그에 포함된 추가 이벤트 관련 데이터입니다.
`jsonPayload.EventCategory`	숫자	이벤트의 카테고리입니다.
`jsonPayload.EventID`	숫자	이벤트 유형을 식별하는 ID입니다.
`jsonPayload.EventType`	문자열	이벤트 유형입니다.
`jsonPayload.Message`	문자열	로그 메시지입니다.
`jsonPayload.Qualifiers`	숫자	이벤트 식별에 사용되는 한정자 번호입니다.
`jsonPayload.RecordNumber`	숫자	이벤트 로그의 시퀀스 번호입니다.
`jsonPayload.Sid`	문자열	이 메시지를 로깅한 프로세스의 보안 주 구성원 또는 보안 그룹을 식별하는 보안 식별자입니다.
`jsonPayload.SourceName`	문자열	이 메시지를 로깅한 소스 구성요소입니다.
`jsonPayload.StringInserts`	[]문자열	로그 메시지를 구성하는 데 사용된 동적 문자열 데이터입니다.
`jsonPayload.TimeGenerated`	문자열	레코드가 생성된 시간을 나타내는 타임스탬프입니다.
`jsonPayload.TimeWritten`	문자열	레코드가 이벤트 로그에 기록된 시간을 나타내는 타임스탬프입니다.

측정항목 수집 구성

AD DS의 측정항목을 수집하려면 AD DS가 생성하는 측정항목에 대한 수신자를 만들고 새 수신자에 대한 파이프라인을 만들어야 합니다.

active_directory_ds 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`collection_interval`	`60s`	`time.Duration` 값(예: `30s` 또는 `5m`)
`type`		값은 `active_directory_ds`여야 합니다.

모니터링 대상

다음 표에서는 작업 에이전트가 AD DS 인스턴스에서 수집하는 측정항목의 목록을 보여줍니다.

측정항목 유형
종류, 유형 모니터링 리소스	라벨
`workload.googleapis.com/active_directory.ds.bind.rate`
`GAUGE`, `DOUBLE` gce_instance	`type`
`workload.googleapis.com/active_directory.ds.ldap.bind.last_successful.time`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.ldap.bind.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/active_directory.ds.ldap.client.session.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.ldap.search.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/active_directory.ds.name_cache.hit_rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/active_directory.ds.notification.queued`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.operation.rate`
`GAUGE`, `DOUBLE` gce_instance	`type`
`workload.googleapis.com/active_directory.ds.replication.network.io`
`CUMULATIVE`, `INT64` gce_instance	`direction` `type`
`workload.googleapis.com/active_directory.ds.replication.object.rate`
`GAUGE`, `DOUBLE` gce_instance	`direction`
`workload.googleapis.com/active_directory.ds.replication.operation.pending`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.replication.property.rate`
`GAUGE`, `DOUBLE` gce_instance	`direction`
`workload.googleapis.com/active_directory.ds.replication.sync.object.pending`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.replication.sync.request.count`
`CUMULATIVE`, `INT64` gce_instance	`result`
`workload.googleapis.com/active_directory.ds.replication.value.rate`
`GAUGE`, `DOUBLE` gce_instance	`direction` `type`
`workload.googleapis.com/active_directory.ds.security_descriptor_propagations_event.queued`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/active_directory.ds.suboperation.rate`
`GAUGE`, `DOUBLE` gce_instance	`type`
`workload.googleapis.com/active_directory.ds.thread.count`
`GAUGE`, `INT64` gce_instance

샘플 대시보드

AD DS 측정항목을 보려면 차트 또는 대시보드가 구성되어 있어야 합니다. Cloud Monitoring은 사전 구성된 차트가 포함된 통합용 샘플 대시보드 라이브러리를 제공합니다. 이러한 대시보드 설치에 대한 자세한 내용은 샘플 대시보드 설치를 참조하세요.

구성 확인

이 섹션에서는 AD DS 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 작업 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 AD DS 로그를 확인합니다.

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/active_directory_ds")

측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.

fetch gce_instance
| metric 'workload.googleapis.com/active_directory.ds.bind.rate'
| every 1m

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.