---
title: "Prometheus Alertmanager — Silences"
source_type: official-doc
url: https://prometheus.io/docs/alerting/latest/alertmanager/
archive_url:
status: raw
confidence: high
tags: [observability, alerting, prometheus, alertmanager, silence, runbook, maintenance]
related_projects: []
related_branches: [feature-operational-runbook-contract]
created: 2026-05-27
last_reviewed: 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:
  - [[raw/branch-notes/feature-operational-runbook-contract]]
- 인용하는 project:
  - [[raw/project-notes/ca-skeleton-operational-contract]]
- 인용한 wiki 요약: (미작성)