Differences

This shows you the differences between two versions of the page.

--- doc:appunti:linux:sa:cacti_122 [2022/03/14 18:00] – [Server NSCA] niccolo
+++ doc:appunti:linux:sa:cacti_122 [2022/03/14 18:24] – [Server NSCA] niccolo
@@ Line 397: / Line 397: @@
     rsync Maildir da Santorini a Naxos eseguito con successo.
 </code>
+==== Ricezione check passivo via REST API ====
+Si verifica che la **[[#rest_api_interface|REST API interface]]** sia attiva (è la stessa che viene usata dal modulo **Icinga Web 2**). Dovrebbe essere in ascolto sulla porta **TCP/5665**.
+Nel file **/etc/icinga2/conf.d/api-users.conf** si definisce un utente con password che abbia l'autorizzazione ad inviare i risultati dei check. L'unico permesso richiesto è **actions/process-check-result**:
+<file>
+// Used to submit passive checks results, e.g. from backup scripts.
+object ApiUser "passive-check" {
+  password = "MyUserSecret"
+  permissions = [ "actions/process-check-result" ]
+}
+</file>
+Il client che deve inviare l'esito del check passivo può utilizzare ad esempio **curl**, con autenticazione su protocollo https:
+<code bash>
+ICINGA2_SERVER='icinga2.rigacci.org'
+ICINGA2_USER='passive-check'
+ICINGA2_PASSWORD='MyUserSecret'
+SERVICE_HOST='Naxos'
+SERVICE_NAME="Backup Remote Rsync"
+EXIT_STATUS="0"
+EXIT_MESSAGE="[OK] Rsync to remote storage"
+curl -k -s -u "${ICINGA2_USER}:${ICINGA2_PASSWORD}" \
+    -H 'Accept: application/json' \
+    -X POST "https://${ICINGA2_SERVER}:5665/v1/actions/process-check-result" \
+    -d '{ "type": "Service",
+          "filter": "host.name==\"'"$SERVICE_HOST"'\" && service.name==\"'"$SERVICE_NAME"'\"",
+          "exit_status": '"$EXIT_STATUS"',
+          "plugin_output": "'"$EXIT_MESSAGE"'" }' > /dev/null
+</code>
+Un servizio Icinga può essere in uno dei seguenti stati:
+^  0 | OK        |
+^  1 | WARNING   |
+^  2 | CRITICAL  |
+^  3 | UNKNOWN   |
 ==== Server NSCA ====
-:!: **ATTENZIONE**: L'utilizzo di NCSA è deprecato, Icinga2 ha la sua interfaccia **REST API** che può essere protetta con HTTPS e autenticazione. La ricezione dei check passivi va fatta via REST API.
+:!: **ATTENZIONE**: L'utilizzo di NCSA è deprecato, Icinga2 ha la sua interfaccia **REST API** che può essere protetta con HTTPS e autenticazione. La ricezione dei check passivi va fatta via REST API come spiegato sopra.
 Nell'ottica di riutilizzare più possibile la configurazione di un vecchio server Nagios3, si utilizza il **Nagios Service Check Acceptor** per ricevere le notifiche dei check passivi. Si tratta di un demone che ascolta sulla **porta TCP/IP 5667** e riceve le notifiche dai vari client per inoltrarle sulla //named pipe// monitorata da Icinga 2. Pertanto sullo stesso host dove viene eseguito Icinga si installa il pacchetto **nsca**.