Impostazione dell'osservabilità per le flotte
La registrazione e il monitoraggio possono aiutare a risolvere i problemi in IBM Cloud® Code Engine e fornire informazioni sulle prestazioni del carico di lavoro. L'impostazione della registrazione e del monitoraggio delle flotte avviene a livello di progetto ed è diversa dalle altre funzioni di Code Engine.
La registrazione e il monitoraggio sono opzionali e possono essere impostati in qualsiasi momento dopo la creazione di un parco macchine.
Impostazione della registrazione per le flotte
La registrazione delle flotte viene impostata a livello di progetto. Dopo aver eseguito queste operazioni di impostazione per un progetto, la registrazione è disponibile per tutte le flotte di quel progetto.
1. Assicurarsi di avere un'istanza del servizio Cloud Logs esistente
È necessario disporre di un'istanza del servizio Cloud Logs che si rivolge alla regione del progetto Code Engine in cui operano le flotte. Per controllare le istanze del servizio Cloud Logs esistenti, andare alla pagina Routing di registrazione nell'interfaccia utente e identificare l'istanza che si rivolge alla regione interessata. Se l'area non ha un'istanza di registrazione mirata, seguire le indicazioni dell'interfaccia utente per impostarne una.
2. Impostare i permessi per l'istanza di Cloud Logs
Assicurarsi di avere un ID servizio e una chiave API che assegnino l'accesso all'istanza di Cloud Logs e impostare le autorizzazioni richieste.
- Crea un ID servizio. Assegnare quindi all'ID del servizio un criterio di accesso mirato all'istanza di Cloud Logs nel proprio account. Assegnare a questo criterio di accesso il livello di accesso al servizio Mittente.
- Creare una chiave API per l'ID del servizio. Salvare la chiave API in un luogo sicuro per poterla consultare in seguito.
3. Ottenere l'endpoint privato di Ingress per l'istanza di Cloud Logs
Ottenere l'endpoint privato di Ingress per l'istanza di Cloud Logs.
- Passare alla pagina Istanze di registrazione nell'interfaccia utente e fare clic sull'istanza pertinente.
- Fare clic su Endpoint.
- Trovare l'endpoint privato di Ingress. Salvare questo valore in un luogo sicuro per poterlo consultare in seguito.
4. Creare un gateway endpoint privato virtuale che si connetta all'istanza di registrazione
Creare un gateway endpoint privato virtuale che si connetta all'istanza di registrazione. Questo gateway VPE deve essere creato nella VPC in cui operano le flotte.
- Passare alla pagina Gateway VPE della console.
- Fai clic su Crea.
- Selezionare la posizione e la regione in cui si trova l'istanza di Cloud Logs.
- Selezionare il VPC in cui operano le flotte.
- Collegare il servizio all'istanza di Cloud Logs.
- Nella sezione Richiedi connessione a un servizio, selezionare l'opzione per IBM Cloud Service.
- Alla voce Offerte di servizi cloud, selezionare Registri cloud.
- In Regioni del servizio cloud, selezionare la regione in cui si trova l'istanza di Cloud Logs.
- Dalla tabella, selezionare l'istanza Cloud Logs pertinente per connettersi alla VPE.
- Fai clic su Crea.
5. Creare indirizzi IP riservati nel gateway VPE
Per ogni zona della VPE, aggiungere un indirizzo IP riservato a una sottorete.
- Passare alla pagina Gateway VPE della console.
- Fare clic sulla VPE creata nel passaggio precedente.
- Fai clic su " Gestisci risorse allegate ".
- Fai clic su “Prenota” o “Assegna IP ”.
- Seguire le istruzioni per riservare un indirizzo IP per una sottorete in una delle zone VPE.
- Ripetere questa procedura per una sottorete in ogni zona VPE.
6. Aggiungete i valori di registrazione al segreto predefinito delle flotte
Aggiungere i valori di registrazione richiesti al segreto predefinito delle flotte.
- Nella console, accedere a Code Engine pagina dei progetti e selezionare il progetto in cui operano le flotte.
- Fare clic su Segreti e configurazioni.
- Fare clic sul segreto
codeengine-fleet-defaults.- Se non è stato creato prima: fare clic su Crea.
- Selezionare Segreto generico, quindi fare clic su Avanti.
- Nome del segreto
codeengine-fleet-defaults. È necessario utilizzare questo nome e questa formattazione.
- Aggiungere le coppie chiave-valore elencate nella tabella seguente. Si noti che i siti
logging_sender_api_keyelogging_ingress_endpointsono stati salvati nelle fasi precedenti.
| Chiave | Valore |
|---|---|
logging_ingress_endpoint |
L'endpoint di ingresso privato per l'istanza Cloud Logs. Questo valore è stato salvato in un passaggio precedente. |
logging_sender_api_key |
La chiave API per l'ID del servizio che si rivolge all'istanza di Cloud Logs. Questo valore è stato salvato in un passaggio precedente. |
logging_ingress_port |
La porta utilizzata per connettersi all'istanza di Cloud Logs. Per le VPE private, specificare 443. |
logging_level_worker |
Il livello di dettaglio che si desidera includere nei registri dei lavoratori. I livelli accettati sono: DEBUG, INFO, WARN, e ERROR. Livello predefinito: WARN. |
logging_level_agent |
Il livello di dettaglio che si desidera includere nei registri degli agenti della flotta. I livelli accettati sono: DEBUG, INFO, WARN, e ERROR. Livello predefinito: WARN. |
7. Visualizzare i registri delle flotte
Ora che la registrazione è stata impostata per le flotte nel progetto Code Engine, è possibile visualizzare i registri della flotta. Per i passi da seguire, vedere Visualizzazione dei registri e dei dati di monitoraggio delle flotte.
Impostazione del monitoraggio delle flotte
Il monitoraggio delle flotte è impostato a livello di progetto. Dopo aver eseguito queste operazioni di impostazione per un progetto, il monitoraggio è disponibile per tutte le flotte di quel progetto.
1. Assicurarsi di avere un'istanza di Clouds Monitoring esistente
È necessario disporre di un'istanza di Cloud Monitoring nella stessa regione del progetto Code Engine a cui appartiene la flotta. Per verificare le istanze del servizio Cloud Monitoring esistenti, accedere alla pagina Monitoraggio delle istanze nell'interfaccia utente e identificare un'istanza nella regione interessata. Se non si dispone di un'istanza adeguata, seguire le indicazioni dell'interfaccia utente per crearne una.
2. Ottenere la chiave dell'agente di monitoraggio
Trovare la chiave dell'agente per l'istanza di monitoraggio.
- Passare alla pagina Monitoraggio istanze dell'interfaccia utente e fare clic sull'istanza interessata. Nella pagina dei dettagli dell'istanza, fare clic su Azioni > Gestisci chiave, quindi fare clic sull'opzione per visualizzare tutte le chiavi nel dashboard.
- Fare clic sulla chiave dell'agente, che può avere un formato simile a
ab1c2345-****-678d9efgh012. Quindi fare clic sull'opzione per copiare la chiave agente completa. - Salvare la chiave dell'agente in un luogo sicuro dove sia possibile accedervi in seguito.
3. Creare un gateway endpoint privato virtuale che si connetta all'istanza di monitoraggio
Creare un gateway endpoint privato virtuale che si connetta all'istanza di monitoraggio. Questo gateway VPE deve essere creato nella VPC in cui operano le flotte.
- Passare alla pagina Gateway VPE della console.
- Fai clic su Crea.
- Seleziona la località e la regione in cui si trova la tua istanza di Cloud Monitoring.
- Selezionare il VPC in cui operano le flotte.
- Collega il servizio alla tua istanza di Cloud Monitoring.
- Nella sezione Richiedi connessione a un servizio, selezionare l'opzione per IBM Cloud Service.
- Alla voce Offerte di servizi cloud, selezionare Cloud Monitoring.
- In Regioni del servizio cloud, selezionare la regione in cui si trova l'istanza Cloud Monitoring.
- Dalla tabella, selezionare l'istanza Cloud Monitoring pertinente per connettersi alla VPE.
- Fai clic su Crea.
4. Creare indirizzi IP riservati nel gateway VPE
Per ogni zona della VPE, aggiungere un indirizzo IP riservato a una sottorete.
- Passare alla pagina Gateway VPE della console.
- Fare clic sulla VPE creata nel passaggio precedente.
- Fai clic su " Gestisci risorse allegate ".
- Fai clic su “Prenota” o “Assegna IP ”.
- Seguire le istruzioni per riservare un indirizzo IP per una sottorete in una delle zone VPE.
- Ripetere questa procedura per una sottorete in ogni zona VPE.
5. Aggiungere i valori di monitoraggio al segreto predefinito delle flotte
- Nella console, accedere a Code Engine pagina dei progetti e selezionare il progetto in cui operano le flotte.
- Fare clic su Segreti e configurazioni.
- Fare clic sul segreto
codeengine-fleet-defaults.- Se non è stato creato prima: fare clic su Crea.
- Selezionare Segreto generico, quindi fare clic su Avanti.
- Nome del segreto
codeengine-fleet-defaults. È necessario utilizzare questo nome e questa formattazione.
- Aggiungere le coppie chiave-valore elencate nella tabella seguente. Si noti che il sito
monitoring_ingestion_keyè stato salvato in un passaggio precedente.
| Chiave | Valore |
|---|---|
monitoring_ingestion_region |
La regione in cui si trova l'istanza di Cloud Monitoring. Esempio: au-syd. |
monitoring_ingestion_key |
La chiave dell'agente di monitoraggio. Questo valore è stato trovato in una fase precedente. |
6. Visualizzate i dati della vostra flotta nel cruscotto di monitoraggio
Ora che il monitoraggio è stato impostato per le flotte nel progetto Code Engine, è possibile visualizzare i dati di monitoraggio della flotta. Per i passi da seguire, vedere Visualizzazione dei registri e dei dati di monitoraggio delle flotte.