Postfix

Supported OS Linux Mac OS

통합 버전3.0.0

Postfix 그래프

개요

이 점검은 Postfix 대기열의 크기를 모니터링합니다.

설정

설치

Postfix 점검은 Datadog 에이전트 패키지에 포함되어 있으므로 Postfix 서버에 추가 설치할 필요가 없습니다.

구성

이 점검을 구성해 find 명령을 사용할 수 있습니다. 그러려면 dd-agent에 sudo 액세스를 부여해 incoming, active, deferred 메일 대기열의 메시지 수를 얻을 수 있습니다.

(선택 사항) 에이전트를 구성해 내장된 postqueue -p 명령을 사용해 active, hold, deferred 메일 대기열의 메시지 수를 얻을 수 있습니다. postqueue의 경우 sudo 권한 없이 설정 그룹 ID 권한으로 실행됩니다.

경고: postqueue를 사용해 메일 대기열을 모니터링하면 incoming 대기열의 메시지 수를 보고하지 않습니다.

메트릭 수집

sudo 사용

  1. 에이전트 설정 디렉터리 루트에 있는 conf.d/ 폴더에서 postfix.d/conf.yaml 파일을 편집합니다. 사용 가능한 모든 옵션은 샘플 postfix.d/conf.yaml을 참고하세요.

    init_config:
  ## @param postfix_user - string - required
  ## The user running dd-agent must have passwordless sudo access for the find
  ## command to run the postfix check.  Here's an example:
  ## example /etc/sudoers entry:
  ##   dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/incoming -type f
  ##
  ## Redhat/CentOS/Amazon Linux flavours need to add:
  ##          Defaults:dd-agent !requiretty
  #
  postfix_user: postfix

instances:
  ## @param directory - string - optional - default: /var/spool/postfix
  ## Path to the postfix directory. The directory option is required if `postqueue: false` is set. For more 
  ## information see https://docs.datadoghq.com/integrations/postfix/#using-sudo.
  #
  - directory: /var/spool/postfix

    ## @param queues - list of string - required
    ## List of queues to monitor.
    #
    queues:
      - incoming
      - active
      - deferred

  2. queues에 있는 각 메일 대기열에 대해 에이전트가 디렉터리에서 find를 분기합니다. 이를 위해 Postfix 사용자의 권한으로 sudo를 사용하기 때문에 에이전트 사용자 dd-agent에 다음 /etc/sudoers 줄을 추가해야 합니다. 이 경우 Postfix가 postfix로 실행된다고 추정합니다.

    dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/incoming -type f
dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/active -type f
dd-agent ALL=(postfix) NOPASSWD:/usr/bin/find /var/spool/postfix/deferred -type f

  3. Agent를 재시작합니다

postqueue 사용

  1. 에이전트 설정 디렉터리의 루트에 있는 conf.d/ 폴더에서 postfix.d/conf.yaml 파일을 편집합니다.

    init_config:
  ## @param postqueue - boolean - optional - default: false
  ## Set `postqueue: true` to gather mail queue counts using `postqueue -p`
  ## without the use of sudo. Postqueue binary is ran with set-group ID privileges,
  ## so that it can connect to Postfix daemon processes.
  ## Only `tags` keys are used from `instances` definition.
  ## Postfix has internal access controls that limit activities on the mail queue.
  ## By default, Postfix allows `anyone` to view the queue. On production systems
  ## where the Postfix installation may be configured with stricter access controls,
  ## you may need to grant the dd-agent user access to view the mail queue.
  ##
  ## postconf -e "authorized_mailq_users = dd-agent"
  ##
  ## http://www.postfix.org/postqueue.1.html
  ##
  ## authorized_mailq_users (static:anyone)
  ## List of users who are authorized to view the queue.
  #
  postqueue: true

instances:
  ## @param config_directory - string - optional
  ## The config_directory option only applies when `postqueue: true`.
  ## The config_directory is the location of the Postfix configuration directory
  ## where main.cf lives.
  #
  - config_directory: /etc/postfix

    ## @param queues - list of string - required
    ## List of queues to monitor.
    #
    queues:
      - incoming
      - active
      - deferred

  2. instances에 있는 각 config_directory에 대해 에이전트는 Postfix 구성 디렉터리의 postqueue -c를 분기합니다. Postfix에는 메일 대기열의 활동을 제한할 수 있는 내부 액세스 컨트롤이 있습니다. 기본적으로 Postfix는 anyone(누구나) 대기열을 볼 수 있도록 합니다. Postfix 설치가 더 엄격한 액세스 컨트롤로 구성되어 있는 프로덕션 시스템의 경우, 메일 대기열을 보려면 dd-agent 사용자 액세스를 부여해야 할 수 있습니다. 상세한 내용은 postqueue Postfix 설명서를 참고하세요.

    postconf -e "authorized_mailq_users = dd-agent"

    대기열 보기 권한이 있는 사용자 목록:

    authorized_mailq_users (static:anyone)

  3. Agent를 재시작합니다.

로그 수집

Agent 버전 6.0 이상에서 사용 가능

Postfix는 syslog daemon에 로그를 전송하고, 그 후 로그를 파일 시스템이 씁니다. 이름 지정 법칙과 로그 파일 대상을 구성할 수 있습니다.

/etc/syslog.conf:
    mail.err                                    /dev/console
    mail.debug                                  /var/log/mail.log

  1. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml파일에서 로그 수집을 사용하도록 설정합니다.

    logs_enabled: true

  2. postfix.d/conf.yaml 파일에 다음 설정 블록을 추가합니다. 환경에 따라 path 및 service 파라미터 값을 변경합니다. 사용 가능한 모든 설정 옵션은 postfix.d/conf.yaml 샘플을 참고하세요.

    logs:
  - type: file
    path: /var/log/mail.log
    source: postfix
    service: myapp

  3. Agent를 재시작합니다.

검증

[에이전트 상태 하위 명령을 실행]75]하고 점검 섹션에서 postfix를 찾습니다.

수집한 데이터

메트릭

postfix.queue.size
(gauge)		The number of messages in a given mail queue, tagged by queue name (e.g. 'queue:incoming') and directory (e.g. 'instance:/var/spool/postfix/incoming').
Shown as email

이벤트

Postfix 점검에는 이벤트가 포함되지 않습니다.

서비스 점검

Postfix 점검에는 서비스 점검이 포함되어 있지 않습니다.

트러블슈팅

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

참고 자료

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

PREVIEWING: guacbot/translation-pipeline