문서
원본 보기2 사용자 정의 간격
개요
아이템이 확인되는 시간에 관한 사용자 정의 규칙을 만들 수 있습니다. 이를 위한 두 가지 방법은 기본 업데이트 간격을 재정의할 수 있는 유연한 간격과 특정 시간 또는 시간 순서에 아이템 검사를 실행할 수 있는 일정 예약입니다.
유연한 간격
유연한 간격을 사용하면 특정 기간에 대해 기본 업데이트 간격을 재정의할 수 있습니다. 유연한 간격은 간격과 기간으로 정의됩니다:
- 간격 - 지정된 기간에 대한 업데이트 간격입니다. 시간 접미사가 지원됩니다 (예: 30s, 1m, 2h, 1d).
- 기간 - 유연한 간격이 활성화되는 시간 기간입니다 (기간 형식에 대한 자세한 설명은 시간 기간 참조)
여러 유연한 간격이 중첩되는 경우, 중첩 기간에는 가장 작은 간격 값이 사용됩니다. 중첩되는 유연한 간격의 최소값이 '0'인 경우 폴링이 수행되지 않습니다. 유연한 간격 외부에서는 기본 업데이트 간격이 사용됩니다.
유연한 간격이 기간의 길이와 같으면 아이템이 정확히 한 번 확인됩니다. 유연한 간격이 기간보다 크면 아이템이 한 번 확인되거나 전혀 확인되지 않을 수 있습니다 (따라서 이러한 구성은 권장되지 않습니다). 유연한 간격이 기간보다 작으면 아이템이 최소한 한 번은 확인됩니다.
유연한 간격이 '0'으로 설정되면 유연한 간격 기간 동안 아이템이 폴링되지 않으며 기간이 끝나면 기본 업데이트 간격에 따라 폴링을 재개합니다. 예시:
| 간격 | 기간 | 설명 |
|---|---|---|
| 10 | 1-5,09:00-18:00 | 근무 시간 동안 10초마다 아이템이 확인됩니다. |
| 0 | 1-7,00:00-7:00 | 밤 시간 동안 아이템이 확인되지 않습니다. |
| 0 | 7-7,00:00-24:00 | 일요일에 아이템이 확인되지 않습니다. |
| 60 | 1-7,12:00-12:01 | 매일 12:00에 아이템이 확인됩니다. 이는 예약된 검사의 해결책으로 사용되었으며, 이러한 검사에는 일정 예약 간격을 사용하는 것이 권장됩니다. |
일정 예약 간격
일정 예약 간격은 특정 시간에 아이템을 확인하는 데 사용됩니다. 유연한 간격이 기본 아이템 업데이트 간격을 재정의하도록 설계된 반면, 일정 예약 간격은 병렬로 실행되는 독립적인 확인 일정을 지정하는 데 사용됩니다.
일정 예약 간격은 다음과 같이 정의됩니다: md<filter>wd<filter>h<filter>m<filter>s<filter> 여기서:
- md - 월일
- wd - 요일
- h - 시간
- m - 분
- s - 초
<filter>는 접두사(일, 시간, 분, 초)에 대한 값을 지정하는 데 사용되며 다음과 같이 정의됩니다: [<from>[-<to>]][/<step>][,<filter>] 여기서:
<from>과<to>는 일치하는 값의 범위를 정의합니다 (포함).<to>가 생략되면 필터는<from> - <from>범위와 일치합니다.<from>도 생략되면 필터는 가능한 모든 값과 일치합니다.<step>은 범위 내에서 숫자 값의 건너뛰기를 정의합니다. 기본적으로<step>의 값은 1이며, 이는 정의된 범위의 모든 값이 일치함을 의미합니다.
필터 정의는 선택사항이지만 최소한 하나의 필터는 사용해야 합니다. 필터는 범위 또는 <step> 값이 정의되어 있어야 합니다.
빈 필터는 하위 레벨 필터가 정의되지 않은 경우 '0'과 일치하고, 그렇지 않으면 가능한 모든 값과 일치합니다. 예를 들어, 시간 필터가 생략되면 분과 초 필터도 생략된 경우 '0' 시간만 일치하고, 그렇지 않으면 빈 시간 필터가 모든 시간 값과 일치합니다.
각 필터 접두사에 대한 유효한 <from>과 <to> 값은 다음과 같습니다:
| 접두사 | 설명 | <from> | <to> |
|---|---|---|---|
| md | 월일 | 1-31 | 1-31 |
| wd | 요일 | 1-7 | 1-7 |
| h | 시간 | 0-23 | 0-23 |
| m | 분 | 0-59 | 0-59 |
| s | 초 | 0-59 | 0-59 |
<from> 값은 <to> 값보다 작거나 같아야 합니다.
<step> 값은 1보다 크거나 같고 <to> - <from>보다 작거나 같아야 합니다.
한 자리 월일, 시간, 분, 초 값은 0을 접두사로 붙일 수 있습니다.
예를 들어, md01-31과 h/02는 유효한 간격이지만 md01-031과 wd01-07은 유효하지 않습니다.
Zabbix 프론트엔드에서는 여러 일정 예약 간격을 별도의 행에 입력합니다.
Zabbix API에서는 세미콜론 ;을 구분자로 사용하여 단일 문자열로 연결됩니다.
여러 간격에서 시간이 일치하는 경우 한 번만 실행됩니다.
예를 들어, wd1h9;h9는 월요일 오전 9시에 한 번만 실행됩니다.
예시:
| 간격 | 실행될 때 |
|---|---|
| m0-59 | 매분 |
| h9-17/2 | 9:00부터 시작하여 2시간마다 (9:00, 11:00 ...) |
| m0,30 또는 m/30 | 매시간 hh:00과 hh:30에 |
| m0,5,10,15,20,25,30,35,40,45,50,55 또는 m/5 | 5분마다 |
| wd1-5h9 | 월요일부터 금요일까지 9:00에 |
| wd1-5h9-18 | 월요일부터 금요일까지 9:00,10:00,...,18:00에 |
| h9,10,11 또는 h9-11 | 매일 9:00, 10:00, 11:00에 |
| md1h9m30 | 매월 1일 9:30에 |
| md1wd1h9m30 | 월요일인 경우 매월 1일 9:30에 |
| h9m/30 | 매일 9:00, 9:30에 |
| h9m0-59/30 | 매일 9:00, 9:30에 |
| h9,10m/30 | 매일 9:00, 9:30, 10:00, 10:30에 |
| h9-10m30 | 매일 9:30, 10:30에 |
| h9m10-40/30 | 매일 9:10, 9:40에 |
| h9,10m10-40/30 | 매일 9:10, 9:40, 10:10, 10:40에 |
| h9-10m10-40/30 | 매일 9:10, 9:40, 10:10, 10:40에 |
| h9m10-40 | 매일 9:10, 9:11, 9:12, ... 9:40에 |
| h9m10-40/1 | 매일 9:10, 9:11, 9:12, ... 9:40에 |
| h9-12,15 | 매일 9:00, 10:00, 11:00, 12:00, 15:00에 |
| h9-12,15m0 | 매일 9:00, 10:00, 11:00, 12:00, 15:00에 |
| h9-12,15m0s30 | 매일 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30에 |
| h9-12s30 | 매일 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30에 |
| h9m/30;h10 (API 전용 구문) | 매일 9:00, 9:30, 10:00에 |
| h9m/30 h10 (프론트엔드에서 별도 행으로 추가) |
매일 9:00, 9:30, 10:00에 |
프록시와 에이전트의 시간대 맞추기
Zabbix 프록시와 에이전트는 일정 예약 간격을 처리할 때 로컬 시간대를 사용합니다.
이러한 이유로 일정 예약 간격이 Zabbix 프록시 또는 에이전트 액티브 아이템에서 모니터링하는 아이템에 적용될 때는 해당 프록시 또는 에이전트의 시간대를 Zabbix 서버와 동일하게 설정하는 것이 권장됩니다. 그렇지 않으면 큐에서 아이템 지연을 잘못 보고할 수 있습니다.
Zabbix 프록시 또는 에이전트의 시간대는 systemd 유닛 파일에서 환경 변수 TZ를 사용하여 설정할 수 있습니다:
[Service]
...
Environment="TZ=Europe/Amsterdam"