Questa pagina si applica ad Apigee, ma non ad Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
Questo documento descrive come monitorare l'integrità di Cloud External Key Manager (Cloud EKM) utilizzato con Apigee e come configurare gli avvisi per i problemi relativi a Cloud EKM utilizzando Cloud Logging.
Apigee potrebbe fare affidamento su Cloud EKM per CMEK. Se Cloud EKM non è disponibile a causa di problemi di rete o se le chiavi sono disabilitate o non raggiungibili, i servizi Apigee che si basano sulla crittografia potrebbero essere interessati.
Monitoraggio dei problemi di Cloud EKM in Cloud Logging
Quando Apigee rileva un problema con Cloud EKM, ad esempio una modifica dello stato in negato, chiave disabilitata, fatturazione disabilitata o chiave non raggiungibile, genera una voce di log in Cloud Logging. Puoi visualizzare questi log in Esplora log e configurare avvisi basati su log per ricevere notifiche di questi eventi.
La voce di log contiene dettagli sull'organizzazione e sull'istanza che presentano il problema, ma omette il nome della chiave per motivi di sicurezza.
Per trovare le voci di log relative a Cloud EKM in Esplora log, segui questi passaggi:
- Vai alla pagina Esplora log nella console Google Cloud .
- Inserisci la seguente query nel campo dell'editor di query e fai clic su Esegui query:
Apigee EKM key health issue detected
- Se si sono verificati problemi di Cloud EKM, i risultati della query mostreranno voci di log che descrivono l'evento.
Configura gli avvisi basati su log per i problemi di Cloud EKM
Puoi creare una policy di avviso basata su log per ricevere una notifica quando Apigee registra un errore relativo a Cloud EKM. Questi avvisi possono aiutarti a identificare e risolvere in modo proattivo i problemi relativi a Cloud EKM.
Per configurare un avviso basato su log in base alla stringa del messaggio di errore di Cloud EKM, consulta Configura le policy di avviso basate su log nella documentazione di Cloud Logging.
Quando crei l'avviso, utilizza lo stesso filtro di query descritto in Monitoraggio dei problemi di Cloud EKM in Cloud Logging per trovare le voci di log di Cloud EKM specifiche.
Limitazioni e ripristino degli avvisi
Tieni presente le seguenti limitazioni quando configuri e rispondi agli avvisi di integrità di Cloud EKM:
- Avvisi ricorrenti: finché una chiave rimane non raggiungibile, Apigee genera una voce di log circa una volta ogni ora. Se configuri un avviso basato su log, riceverai una notifica con questa cadenza fino alla risoluzione del problema sottostante.
- Nessuna notifica di ripristino: Apigee non genera una voce di log né invia una notifica quando Cloud EKM torna raggiungibile. Un avviso basato su log si risolve da solo dopo che Apigee smette di generare le voci di log degli errori, in base alla configurazione di chiusura automatica della criterio di avviso.
- Verifica del ripristino: poiché non viene generata alcuna voce di log di ripristino, verifica che Cloud EKM sia nuovamente raggiungibile eseguendo un'operazione che richiede la chiave, ad esempio il deployment di un proxy API, e verifica che l'operazione vada a buon fine.
Limitazioni della risoluzione dei problemi
Il logging di Apigee indica quando si verifica un problema con la connessione o lo stato della chiave di Cloud EKM. Tuttavia, la risoluzione dei problemi dettagliata di Cloud EKM (ad esempio, la diagnosi di problemi di connessione di rete o di problemi sul lato del gestore delle chiavi esterno) non rientra nell'ambito del monitoraggio di Apigee. Se ricevi avvisi relativi a problemi di Cloud EKM, devi esaminare l'integrità e la configurazione del servizio Cloud EKM.