Supervisord

문서 > 통합 > Supervisord

Supported OS Linux Mac OS Windows

통합 버전4.0.0

Supervisor 이벤트

개요

본 검사는 Supervisor에서 실행 중인 프로세스의 수, 업타임, 상태를 모니터링합니다.

설정

설치

Supervisor 검사는 Datadog Agent 패키지에 포함되어 있으므로 Supervisor가 실행 중인 서버에 추가 설치할 필요가 없습니다.

구성

Supervisord 준비

Agent는 HTTP 서버 또는 UNIX 소켓을 통해 Supervisor로부터 데이터를 수집할 수 있습니다. Agent는 어떤 수집 메서드를 구성하든 동일한 데이터를 수집합니다.

HTTP 서버

Supervisor의 메인 구성 파일(/etc/supervisor.conf)에 다음 블록을 추가합니다.

[inet_http_server]
port=localhost:9001
;username=user  # optional
;password=pass  # optional

UNIX 소켓

아직 없다면 /etc/supervisor.conf에 다음 블록을 추가합니다.

[supervisorctl]
serverurl=unix:///var/run/supervisor.sock

[unix_http_server]
file=/var/run/supervisor.sock
chmod=777
chown=nobody:nogroup
;username=user  # optional
;password=pass  # optional

Supervisor가 루트로 실행된다면, chmod 또는 chown이 설정되어 있는지 확인하여 비루트 사용자(예: dd-agent)가 소켓을 읽을 수 있게 합니다.

supervisord를 다시 로드합니다.

호스트

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면:

Agent 구성 디렉터리 루트의 conf.d/ 폴더에 있는 supervisord.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 구성 옵션은 샘플 supervisord.d/conf.yaml에서 확인하세요.

init_config:

instances:
  ## 태그 서비스 점검 및 메트릭 사용. 예: supervisor_server:supervisord0
  - name: supervisord0
    host: localhost
    port: 9001
  ## 대신 소켓에서 수집
  # - name: supervisord0
  #   socket: unix:///var/run/supervisor.sock

proc_names 및/또는 proc_regex 옵션을 통해 Agent가 메트릭을 수집하고 서비스 검사를 생성할 프로세스를 나열합니다. 두 옵션 중 하나를 제공하지 않는다면 Agent는 Supervisor의 모든 자식 프로세스를 추적합니다. 두 옵션을 모두 제공하면, Agent가 두 목록의 프로세스를 모두 추적하므로 두 옵션은 상호배타적이지 않습니다.

다른 검사 옵션에 대한 자세한 설명은 확인 구성 예시를 참조하세요.

Agent를 다시 시작하여 Datadog으로 Supervisor 메트릭을 전송하기 시작합니다.

컨테이너화

컨테이너화된 환경의 경우 자동탐지 통합 템플릿에 다음 파라미터를 적용하는 방법이 안내되어 있습니다.

파라미터	값
`<INTEGRATION_NAME>`	`supervisord`
`<INIT_CONFIG>`	비어 있음 또는 `{}`
`<INSTANCE_CONFIG>`	`{"name":"<SUPERVISORD_SERVER_NAME>", "host":"%%host%%", "port":"9001", "username":"<USERNAME>", "password":"<PASSWORD>"}`

로그 수집

Datadog Agent에서는 로그 수집이 기본적으로 비활성화되어 있습니다. datadog.yaml 파일에서 활성화해야 합니다.
```
logs_enabled: true
```
Supervisord 로그 수집을 시작하려면 supervisord.d/conf.yaml 파일에 이 구성 블록을 추가하세요.
```
logs:
  - type: file
    path: /path/to/my/directory/file.log
    source: supervisord
```
path 파라미터 값을 변경하고 환경에 맞게 설정합니다. 사용 가능한 모든 구성 옵션은 supervisord.d/conf.yaml 샘플을 참조하세요.
Agent를 재시작합니다.

검증

Agent의 상태 하위 명령을 실행하고 Checks 섹션에서 supervisord를 찾습니다.

수집한 데이터

메트릭


supervisord.process.count (gauge)	The number of supervisord monitored processes Shown as process
supervisord.process.uptime (gauge)	The process uptime Shown as second

이벤트

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

서비스 점검

supervisord.can_connect

Returns CRITICAL if the Agent check is unable to connect to the supervisor daemon. Returns OK otherwise.

Statuses: ok, critical

supervisord.process.status

Returns CRITICAL if the process is not running or stopping, UNKNOWN if starting or unknown, OK otherwise.

Statuses: ok, critical, unknown

트러블슈팅

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

참고 자료

Supervisor가 프로세스를 모니터합니다. Datadog이 Supervisor를 모니터합니다.