Introduzione a IBM® Cloud Logs Routing
Utilizzare il servizio IBM Cloud Logs Routing per instradare i registri della piattaforma dall'account IBM Cloud alla destinazione scelta.
Con il rilascio di IBM Cloud Logs Routing REST API V3, è possibile migrare l'account per utilizzare l'API V3 in modo da instradare i log della piattaforma verso più destinazioni e gestire il servizio a livello di account Enterprise utilizzando i controlli di azione IAM aziendali. Per ulteriori informazioni sulla migrazione, vedere Migrazione all'uso di IBM Cloud Logs Routing REST API V3. Se si dispone di un nuovo account, seguire la procedura descritta in Come iniziare con più destinazioni.
Completare i passaggi seguenti per iniziare a usare IBM® Cloud Logs Routing:
Prima di iniziare
-
Se non si dispone di un account IBM Cloud, registrare un account IBM Cloud. Hai bisogno di un ID IBM per utilizzare IBM Cloud.
-
Per configurare i registri della piattaforma, è necessario configurare i tenant e i target (destinazioni) nel proprio account IBM Cloud.
Un tenant è la configurazione specifica dell'account di IBM Cloud Logs Routing in esecuzione in una regione. È possibile definire fino a 1 destinazione di destinazione per tenant e per regione. La destinazione definisce il percorso dei log.
Per ulteriori informazioni, vedere Per saperne di più su IBM Cloud Logs Routing.
-
Controlla le regioni in cui è disponibile il servizio IBM Cloud Logs Routing. Identificare una regione in cui si opera in IBM Cloud e verificare che sia presente nell'elenco delle regioni supportate.
-
Verificare che l'utente che sta configurando IBM Cloud Logs Routing per l'account IBM Cloud® abbia autorizzazioni sufficienti per gestire il servizio IBM Cloud Logs Routing. Per ulteriori informazioni, vedere Gestione dell'accesso IAM per IBM Cloud Logs Routing.
È necessario il ruolo di servizio lettore per visualizzare i tenant e i target.
È necessario il ruolo di servizio manager per creare, eliminare e aggiornare i tenant e i target.
-
Installare i seguenti strumenti:
-
Scarica e installa la CLI IBM Cloud®.
-
Provisionare un'istanza di IBM Cloud Logs. Per ulteriori informazioni, vedi Provisioning di un'istanza.
-
Scaricare e installare jq per elaborare l'output e interrogare i risultati desiderati.
-
Creazione di un'autorizzazione da servizio a servizio
È necessario utilizzare IBM Cloud® Identity and Access Management (IAM) per creare un'autorizzazione che conceda a IBM Cloud Logs Routing l'accesso a IBM Cloud Logs in modo che il servizio IBM Cloud Logs Routing possa inviare i log alla destinazione dell'istanza IBM Cloud Logs.
È necessario avere il ruolo di mittente per IBM Cloud Logs prima di configurare il servizio per l'autorizzazione al servizio.
Completa i seguenti passi:
-
Nella console IBM Cloud , fare clic su Gestisci > Accesso (IAM) e selezionare Autorizzazioni.
-
Fai clic su Crea.
-
Configurare l'account di origine. Selezionate Questo conto.
-
Selezionare Logs Routing come servizio di origine. Quindi, impostare l'ambito dell'accesso su Tutte le risorse.
-
Selezionare Cloud Logs come servizio di destinazione. Quindi, impostare l'ambito dell'accesso su Tutte le risorse, che garantisce l'accesso a tutte le istanze IBM Cloud Logs, o a una singola istanza configurando Risorse basate sugli attributi selezionati > Istanza di servizio.
Altri attributi non sono supportati per questo tipo di autorizzazione.
-
Nella sezione Accesso al servizio, selezionare Mittente per assegnare l'accesso al servizio di origine che accede al servizio di destinazione.
-
Fai clic su Autorizza.
Per ulteriori informazioni, vedere Creazione di un'autorizzazione S2S per concedere l'accesso all'invio dei registri a IBM Cloud Logs.
Creazione di un inquilino
Quando la console IBM Cloud Logs Routing viene visualizzata per la prima volta, vengono visualizzate tutte le informazioni di destinazione esistenti.
Se per una regione non è configurato alcun target, la regione visualizza l'opzione Imposta target.
Dalla console IBM Cloud Logs Routing, è possibile creare un tenant e una destinazione di destinazione configurando l'opzione Imposta destinazione per la regione che si desidera configurare.
Completa i seguenti passi:
-
Fare clic sull'icona Menu
> Osservabilità.
-
Fare clic su Logging > Routing.
-
Fare clic su Imposta obiettivo.
-
Fare clic sulla scheda Registri cloud e selezionare un'istanza IBM Cloud Logs dall'elenco. Questa è l'istanza in cui si desidera ricevere i registri instradati da IBM Cloud Logs Routing.
È possibile selezionare un'istanza di IBM Cloud Logs dall'elenco.
L'istanza di IBM Cloud Logs deve trovarsi nello stesso account che si sta configurando.
-
Fare clic su Salva.
Verifica dell'invio dei log alla destinazione di destinazione
Verificare che i registri del cluster siano indirizzati all'istanza IBM Cloud Logs.
Tutti i log della piattaforma sono generati in JSON. È possibile filtrare i registri della piattaforma nella propria istanza selezionando il valore di ibm-platform-logs come applicationName.
Completa i seguenti passi:
- Avviare l'interfaccia web IBM Cloud Logs per l'istanza IBM Cloud Logs configurata come target per la raccolta dei log della piattaforma in una regione. Si tratta dell'istanza selezionata nel passaggio in cui si è impostato un target.
- Visualizzare i registri attraverso viste personalizzate. Per ulteriori informazioni, vedi Visualizzazione dei log.