6.8 KiB
title, source_type, url, archive_url, status, confidence, tags, related_projects, related_branches, created, last_reviewed
| title | source_type | url | archive_url | status | confidence | tags | related_projects | related_branches | created | last_reviewed | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Prometheus Alertmanager — Silences | official-doc | https://prometheus.io/docs/alerting/latest/alertmanager/ | raw | high |
|
|
2026-05-27 | 2026-05-27 |
Prometheus Alertmanager — Silences
Layer:
raw/official-docs/— Prometheus Alertmanager 공식 문서의 "Silences" 섹션 원문 발췌. ca-tmpl runbook 의 maintenance window 동안 알람 suppression 메커니즘의 근거.
Parent / 활용 branch (필수)
| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| raw/branch-notes/feature-operational-runbook-contract | D6 maintenance window 중 알람 silence 메커니즘 채택 근거 — Alertmanager 의 silence 가 시간 제한 + matcher 기반 알람 mute 의 공식 메커니즘 |
컨텍스트
ca-tmpl feature-operational-runbook-contract 의 D6 는 계획된 maintenance / deploy window 동안 false-positive 알람이 oncall 을 깨우지 않도록 silence 를 적용한다는 결정. 본 source 는 그 silence 메커니즘의 Prometheus 공식 정의 — silence 는 시간 제한 mute 이며 matcher (equality 또는 regex) 로 대상 알람을 지정.
출처 / Source
- 원본 URL: https://prometheus.io/docs/alerting/latest/alertmanager/
- 직접 anchor: https://prometheus.io/docs/alerting/latest/alertmanager/#silences
- 아카이브 URL: (미수집)
- 저자 / 조직: Prometheus Authors (CNCF)
- 발행일: rolling docs
- 마지막 확인일: 2026-05-27
왜 저장했는지 / Why archived
maintenance window 알람 처리를 "Alertmanager silence 를 쓴다" 라고 결정할 때, silence 가 (a) 시간 제한 mute 이며 (b) matcher 기반으로 대상 알람을 지정한다는 두 핵심 속성을 공식 verbatim 으로 보존. ca-tmpl runbook 의 "maintenance window 시작 시 silence 생성, 종료 시 자동 만료" 흐름의 근거.
핵심 인용 / Key quotes (verbatim)
[§Silences] "Silences are a straightforward way to simply mute alerts for a given time."
[§Silences] "A silence is configured based on matchers, just like the routing tree."
[§Silences] "Incoming alerts are checked whether they match all the equality or regular expression matchers of an active silence."
[§Silences] "If they do, no notifications will be sent out for that alert."
[§Silences] "Silences are configured in the web interface of the Alertmanager."
Claims Extracted / 추출된 주장
| Claim ID | Claim (이 자료가 직접 말하는 것) | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| ALERTMANAGER-SIL-C1 | silence 는 주어진 시간 동안 알람을 mute 하는 메커니즘 (= 시간 제한 suppression) | [§Silences] "Silences are a straightforward way to simply mute alerts for a given time." | official-vendor-doc |
Alertmanager 가 처리하는 모든 알람 | "given time" 의 정확한 grammar (start / end / duration / 무기한 silence 가능 여부) 는 본 인용 범위 밖 — UI / API spec 별도 |
| ALERTMANAGER-SIL-C2 | silence 는 routing tree 와 동일한 방식으로 matcher 기반으로 설정 | [§Silences] "A silence is configured based on matchers, just like the routing tree." | official-vendor-doc |
silence 와 routing 모두 | routing tree 의 정확한 spec 은 별도 (alertmanager config route:) |
| ALERTMANAGER-SIL-C3 | incoming alert 가 active silence 의 equality 또는 regex matcher 를 모두 (all) 만족하면 silence 적용 | [§Silences] "Incoming alerts are checked whether they match all the equality or regular expression matchers of an active silence." | official-vendor-doc |
silence 의 매칭 조건 평가 | matcher 가 부분 일치 / 음의 매칭 (negation) 을 어떻게 표현하는지는 별도 spec (matcher syntax) |
| ALERTMANAGER-SIL-C4 | silence 가 매칭된 알람은 notification 이 전송되지 않음 | [§Silences] "If they do, no notifications will be sent out for that alert." | official-vendor-doc |
silence 매칭된 모든 알람 | silence 가 알람 자체의 firing 상태를 변경하지 않음 (= 알람은 여전히 발화 중이고 notification 만 억제) 은 본 인용 범위 밖 (관습적 해석) |
| ALERTMANAGER-SIL-C5 | silence 는 Alertmanager 의 web interface 에서 설정 | [§Silences] "Silences are configured in the web interface of the Alertmanager." | official-vendor-doc |
UI 기반 silence 관리 | API / amtool CLI 를 통한 설정 가능 여부는 본 인용 범위 밖 (실제로는 가능하나, 본 verbatim 에는 web interface 만 명시) |
Strength
모두 official-vendor-doc (Prometheus Authors / Alertmanager docs).
Usage Boundaries / 적용 경계
- 이 자료가 직접 증명하는 것:
ALERTMANAGER-SIL-C1: silence 의 시간 제한 mute 정의ALERTMANAGER-SIL-C2~C3: matcher 기반 대상 지정 + AND (all) 조건ALERTMANAGER-SIL-C4: notification 전송 차단ALERTMANAGER-SIL-C5: web interface 가 설정 channel 의 하나
- 이 자료가 증명하지 않는 것:
- silence 의 정확한 start/end time 모델 — "given time" 만 명시되어 만료 / 무한 silence 가능 여부 verbatim 부재
- silence 생성 시 author / comment 필수 여부
- silence 의 만료된 후 history 보관 정책
- amtool / Alertmanager API 를 통한 silence 자동화 — 본 인용은 web interface 만 명시
- silence 가 알람 자체의 firing 상태를 바꾸지 않음 (= notification 만 억제) — 관습이지만 본 verbatim 에는 없음
- 내 프로젝트 (ca-tmpl) 에 적용하려면 추가 확인이 필요한 것:
- ca-tmpl runbook 의 maintenance window 자동화에서 silence 를 amtool CLI 로 생성할지, 또는 web UI 수동 생성할지 — amtool spec 별도 확인
- silence 의 matcher 로 ca-tmpl 의 alert label (예:
service="ca-tmpl",severity="warning") 이 정확히 매칭되는지 검증 - silence 만료 후 알람이 자동 재발화되는지 (deploy 종료 후 정상화 검증)
메모 / Notes
- 본 capture 는 silence 의 개념 정의 만 보존 — silence 의 detailed UI / API / amtool spec 은 별도 fetch 필요 (Alertmanager API reference 또는 amtool CLI docs).
- 다음 후보 fetch:
- Alertmanager amtool docs (silence create/expire CLI)
- Alertmanager API reference (POST /api/v2/silences)
- matcher syntax spec (equality / regex / negation)
Related / 관련
- 같은 주제 다른 official-doc / company-tech-blog: (없음 — alerting 도메인의 sister capture 미수집)
- 인용하는 branch:
- 인용하는 project:
- 인용한 wiki 요약: (미작성)