ccfos/nightingaleMotore di allerta open-source per dati di monitoraggio di serie temporali. Si connette a Prometheus, VictoriaMetrics, ElasticSearch e altre fonti di dati. Supporta oltre 20 canali di notifica, riduzione del rumore degli avvisi, escalation e automazione di auto-riparazione.
<p align="center">
<a href="https://github.com/ccfos/nightingale">
<img src="https://assets.kitploit.com/production/public/readmes/6912/478fc7d999847e20a15fb5b231650ebbb0d483edba4ce0b313091fac474416f2.png" alt="Nightingale" width="100" />
</a>
</p>
<p align="center">
<b>Alerting open-source per il tuo stack esistente</b>
</p>
<p align="center">
<a href="https://github.com/ccfos/nightingale/releases"><img alt="Ultima release" src="https://img.shields.io/github/v/release/ccfos/nightingale" /></a>
<a href="https://github.com/ccfos/nightingale/blob/main/LICENSE"><img alt="Licenza Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue" /></a>
<a href="https://github.com/ccfos/nightingale/stargazers"><img alt="Stelle su GitHub" src="https://img.shields.io/github/stars/ccfos/nightingale" /></a>
<a href="https://hub.docker.com/r/flashcatcloud/nightingale"><img alt="Download Docker" src="https://img.shields.io/docker/pulls/flashcatcloud/nightingale" /></a>
<a href="https://join.slack.com/t/n9e/shared_invite/zt-480klxytf-P9qm3C1M87kDmRPp_H30Kw"><img alt="Unisciti alla community Slack di Nightingale" src="https://img.shields.io/badge/Slack-join%20the%20community-brightgreen" /></a>
</p>
<p align="center">
<a href="#quick-start">Avvio rapido</a> ·
<a href="https://n9e.github.io/docs">Documentazione</a> ·
<a href="https://n9e.github.io/download">Download</a> ·
<a href="https://github.com/ccfos/nightingale/releases">Release</a> ·
<a href="#community">Community</a>
</p>
[English](https://github.com/ccfos/nightingale/blob/main/README.md) | [中文](https://github.com/ccfos/nightingale/blob/main/README_zh.md)
Nightingale riunisce in un unico luogo regole di alerting, elaborazione degli eventi e instradamento delle notifiche. Collega Prometheus, VictoriaMetrics, Elasticsearch, Loki, ClickHouse e altre fonti dati che già utilizzi, quindi invia gli alert a Slack, PagerDuty e agli strumenti già in uso nel tuo team.
**Self-hosted · Apache-2.0 · Agente AI integrato · Server MCP**
## Perché Nightingale?
- **Dai ai team la proprietà dei propri alert.** Organizza le regole in gruppi aziendali, assegna i permessi ai team e gestisci regole e impostazioni di notifica tramite UI e API.
- **Raccogli in un unico luogo un'alerting frammentato.** Valuta le regole su fonti dati di metriche, log e SQL mantenendo i tuoi collector, storage e dashboard Grafana esistenti.
- **Comprendi cosa è successo a un alert.** Ispeziona i record di valutazione delle regole, gli eventi storici e i risultati delle notifiche per tracciare una query fino alla consegna.
## Avvio rapido
Con Git e Docker Compose installati, avvia lo stack di valutazione incluso:
```bash
git clone https://github.com/ccfos/nightingale.git
cd nightingale/docker/compose-bridge
docker compose up -d
```
Questo avvia Nightingale, MySQL, Redis, VictoriaMetrics e Categraf. Apri [http://localhost:17000](http://localhost:17000) e accedi con **`root` / `root.2020`**.
Per ottenere il tuo primo avviso:
1. **Connetti un'origine dati.** Aggiungi il tuo endpoint esistente compatibile con Prometheus, oppure usa `http://victoriametrics:8428` per l'istanza VictoriaMetrics in questo stack Compose.
2. **Crea una regola di avviso.** Scegli un gruppo aziendale e un'origine dati, poi inserisci un'espressione PromQL. Per un test sempre attivo, usa `vector(1) > 0` e imposta la durata a `0`.
3. **Configura la consegna.** Imposta un canale di notifica, crea una regola di notifica e collegala alla regola di avviso. Verifica che la notifica di test arrivi, poi disabilita l'avviso di test.
Lo stack Compose utilizza credenziali di esempio ed espone le porte dei servizi per la valutazione locale. Cambia le credenziali e rivedi l'accesso alla rete prima di distribuire su un host condiviso o pubblico. Consulta le [opzioni di distribuzione](#deployment) per altri modi di eseguire Nightingale.
## Come si integra nel tuo stack
Nightingale interroga le tue origini dati, valuta le condizioni di avviso, elabora gli eventi e instrada le notifiche. I tuoi dati esistenti rimangono nei loro archivi attuali.
Mantieni Grafana per la visualizzazione e la tua piattaforma di on-call per pianificazione, escalation e gestione degli incidenti. Nightingale include anche dashboard per i team che desiderano esplorare i dati insieme ai propri avvisi.
Parti senza uno stack di monitoraggio? La configurazione standalone include un TSDB incorporato opzionale per distribuzioni piccole e a istanza singola. [Categraf](https://github.com/flashcatcloud/categraf) è un collector opzionale per host, middleware, database e dispositivi di rete.
## Funzionalità principali
| Funzionalità | Cosa puoi fare |
| --- | --- |
| Avvisi su più origini dati | Usa PromQL, query di log o SQL per definire le condizioni. Applica una regola a più istanze dello stesso tipo di origine dati. |
| Proprietà del team | Raggruppa regole e dashboard per gruppo aziendale, assegna i permessi del team e collega OIDC, OAuth2, LDAP o CAS per l'accesso. |
| Elaborazione e instradamento degli eventi | Silenzia le notifiche, iscriviti agli avvisi, arricchisci o riscrivi le etichette e instrada gli eventi tramite pipeline condizionali. |
| Registri di esecuzione degli avvisi | Consulta le query e i risultati di valutazione, gli eventi attivi e storici e i registri di consegna delle notifiche. |
| Integrazioni riutilizzabili | Inizia con configurazioni di collector, regole di avviso e dashboard predefiniti. Rivedi query e soglie per il tuo ambiente prima di abilitarli. |
| Valutazione distribuita | Distribuisci le regole tra i motori di avviso e usa `n9e-edge` per valutare gli avvisi vicino alle origini dati remote. |
Le integrazioni di notifica includono **Slack, PagerDuty, Discord, Email, Telegram, Mattermost, Jira e Jira Service Management**, con webhook HTTP e script per destinazioni personalizzate. Consulta il [riferimento ai canali di notifica nativi](https://github.com/ccfos/nightingale/blob/main/doc/api/notify-channel-native.md) per i dettagli di configurazione.
Per risposte automatizzate, collega [ibex](https://github.com/flashcatcloud/ibex) per eseguire script di remediation predefiniti quando scatta un avviso.
<a id="-mcp-server"></a>
<a id="ai-assistant-and-mcp"></a>
## Agente AI integrato
Nightingale include un agente AI che puoi utilizzare direttamente nell'interfaccia web. L'agente viene eseguito all'interno di Nightingale, chiama strumenti per ispezionare i tuoi dati di monitoraggio e la configurazione, e svolge le attività in più passaggi.
- **Analizzare gli avvisi.** Interrogare metriche e log correlati, ispezionare gli host interessati e spiegare i risultati utilizzando i dati recuperati.
- **Risolvere i problemi del processo di avviso.** Ispezionare le regole, i log di valutazione, le impostazioni di silenziamento, l'elaborazione degli eventi e i risultati delle notifiche per scoprire perché un avviso non è stato attivato o non ha raggiunto la destinazione.
- **Creare e aggiornare la configurazione.** Creare regole di avviso e dashboard, generare PromQL e SQL e configurare regole di notifica, silenziamenti e sottoscrizioni tramite conversazione. Gli strumenti integrati per l'aggiornamento delle regole di avviso e delle dashboard esistenti presentano le modifiche proposte per la conferma.
- **Estenderlo con le Skills.** Le Skills incluse coprono i flussi di lavoro di monitoraggio comuni. Aggiungi le procedure, il materiale di riferimento e gli script del tuo team come Skills personalizzate, incluse le Skills importate da Git.
Ad esempio:
> Perché è stato attivato questo avviso? Controlla le metriche e i log dell'host interessato intorno all'ora di attivazione.
> Crea un avviso sull'utilizzo della memoria per gli host di produzione e notifica il nostro team su Slack.
Configura un endpoint del modello per iniziare. L'agente supporta API compatibili con OpenAI, Claude, Gemini e modelli self-hosted compatibili. Scegli tu il servizio del modello e le credenziali; le funzionalità di avviso principali funzionano indipendentemente dall'agente.
[Configurazione del provider del modello](https://github.com/ccfos/nightingale/blob/main/doc/api/ai-llm-config.md) · [Gestione delle Skills](https://github.com/ccfos/nightingale/blob/main/doc/api/ai-skill.md) · [Skills incluse](https://github.com/ccfos/nightingale/blob/main/aiagent/skill/embedded/builtin)
### Connettere agenti esterni
- **MCP** consente agli assistenti esterni di chiamare gli strumenti di Nightingale. Il server viene eseguito all'interno di Nightingale su `/mcp`, espone per impostazione predefinita gli strumenti di lettura e applica i permessi API esistenti del chiamante. Gli strumenti di scrittura richiedono una configurazione esplicita. Vedi [Configurazione MCP](https://github.com/ccfos/nightingale/blob/main/doc/api/mcp-server.md).
- **A2A** consente a un altro agente di delegare un'attività all'agente integrato di Nightingale. Vedi [Integrazione A2A](https://github.com/ccfos/nightingale/blob/main/doc/api/a2a-integration.md).
## Screenshot del prodotto
Gestisci le regole di avviso per origine dati e gruppo aziendale:
## Distribuzione
| Opzione | Inizia da qui |
| --- | --- |
| Valutazione locale con Docker Compose | [Stack Compose incluso](https://github.com/ccfos/nightingale/blob/main/docker/compose-bridge/docker-compose.yaml) |
| Binari Linux per amd64 e arm64 | [Download delle release](https://github.com/ccfos/nightingale/releases) e [riferimento alla configurazione](https://github.com/ccfos/nightingale/blob/main/etc/config.toml) |
| Kubernetes | [Chart Helm e istruzioni di installazione](https://github.com/flashcatcloud/n9e-helm) |
Per la produzione, fissa una release, configura credenziali e TLS, esegui il backup del database dei metadati e monitora la valutazione delle regole e gli errori di notifica. Più istanze di Nightingale condividono un database dei metadati e Redis; utilizza uno storage di serie temporali esterno per una distribuzione multi-istanza. Il TSDB integrato memorizza i dati sul disco locale di una singola istanza.
Consulta la [documentazione](https://n9e.github.io/docs), la [guida all'installazione](https://n9e.github.io/docs/install/overview), le [note di rilascio](https://github.com/ccfos/nightingale/releases) e la [politica di sicurezza](https://github.com/ccfos/nightingale/blob/main/SECURITY.md) per ulteriori indicazioni e versioni supportate.
## FAQ
**Devo sostituire i miei collector o spostare i miei dati di monitoraggio?**
No. Nightingale può interrogare direttamente le tue origini dati esistenti. Mantieni i tuoi exporter e collector. Categraf e il TSDB integrato sono disponibili quando hai bisogno di raccolta o archiviazione locale.
**Posso importare regole di avviso Prometheus esistenti?**
Sì. L'importazione delle regole supporta YAML di Prometheus, incluse espressioni, durate, etichette e annotazioni. Rivedi le regole convertite e ricostruisci l'instradamento delle notifiche in Nightingale. L'importazione non è una conversione completa di `alertmanager.yml`; esegui entrambi i sistemi durante la valutazione prima di passare le notifiche.
**Posso gestire le regole tramite Git e CI?**
Le regole possono essere esportate come JSON e create o aggiornate tramite l'API HTTP, così puoi costruire un flusso di lavoro basato su una configurazione versionata. Attualmente Nightingale non fornisce una cronologia delle revisioni delle regole integrata né il ripristino a revisioni precedenti.
**L'AI è obbligatoria e dove vengono inviate le richieste al modello?**
L'alerting funziona senza AI. L'assistente integrato invia i prompt e i dati che utilizza al tuo endpoint del modello configurato; puoi usare un modello ospitato nella tua rete. I client MCP esterni utilizzano le proprie impostazioni del modello. Le credenziali del servizio del modello e i costi di utilizzo sono gestiti da te.
**Nightingale fornisce pianificazione on-call ed escalation?**
Collega una piattaforma on-call come PagerDuty per pianificazioni, politiche di escalation e risposta agli incidenti. Nightingale gestisce la valutazione delle regole, l'elaborazione degli eventi e l'instradamento delle notifiche.
## Community
Domande, segnalazioni di bug, miglioramenti alla documentazione e contributi sono benvenuti in inglese.
- [GitHub Discussions](https://github.com/ccfos/nightingale/discussions) — fai domande e condividi idee.
- [GitHub Issues](https://github.com/ccfos/nightingale/issues) — segnala bug e richiedi funzionalità. Includi la versione, il metodo di deployment e i passaggi per riprodurre il problema.
- [Slack](https://join.slack.com/t/n9e/shared_invite/zt-480klxytf-P9qm3C1M87kDmRPp_H30Kw) — unisciti alla community.
- [Adopter reports](https://github.com/ccfos/nightingale/issues/897) — scopri come altri usano Nightingale e condividi la tua esperienza.
- [Security policy](https://github.com/ccfos/nightingale/blob/main/SECURITY.md) — segnala le vulnerabilità in privato e verifica il supporto delle versioni.
Per modifiche sostanziali, apri una issue per discutere l'approccio prima di inviare una pull request. Ti preghiamo di seguire il [Code of Conduct](https://github.com/ccfos/nightingale/blob/main/CODE_OF_CONDUCT.md).
Nightingale è stato originariamente sviluppato presso DiDi e donato a CCF ODC nel 2022. Scopri di più sulla [project governance](https://github.com/ccfos/nightingale/blob/main/doc/community-governance.md), sui [committers](https://github.com/ccfos/nightingale/blob/main/doc/committers.md) e sui [contributors](https://github.com/ccfos/nightingale/graphs/contributors).
<a href="https://github.com/ccfos/nightingale/graphs/contributors">
<img alt="Nightingale contributors" src="https://contrib.rocks/image?repo=ccfos/nightingale" />
</a>
## Stargazers over time
[](https://star-history.dera.page/#ccfos/nightingale&Date)
## License
Nightingale è disponibile sotto la [Apache License 2.0](https://github.com/ccfos/nightingale/blob/main/LICENSE).
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=3f539666-22f5-468d-914d-1e344945d3d8" alt="" />
