Prima di iniziare

1. Se non avete un account IBM Cloud, registrate un account IBM Cloud. Hai bisogno di un ID IBM per utilizzare IBM Cloud.

2. Controlla le regioni in cui è disponibile il servizio IBM Cloud Logs Routing.

3. Verificare che l'utente che sta configurando IBM Cloud Logs Routing per l'account IBM Cloud® abbia i permessi sufficienti per gestire il servizio IBM Cloud Logs Routing. Per ulteriori informazioni, vedere Gestione dell'accesso IAM per IBM Cloud Logs Routing.

   Per gestire le risorse è necessario il ruolo Adminsitrator della piattaforma.

4. Installare i seguenti strumenti:

   • Scarica e installa la CLI IBM Cloud®.

   • Scaricare e installare jq per elaborare l'output e interrogare i risultati desiderati.

5. Fornire o avere accesso a un'istanza di IBM Cloud Logs. Per ulteriori informazioni, vedi Provisioning di un'istanza.

Creazione di un'autorizzazione da servizio a servizio

È necessario usare 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 (target) 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:

1. Nella console IBM Cloud , fare clic su Gestisci > Accesso (IAM) e selezionare Autorizzazioni.

2. Fai clic su Crea.

3. Configurare l'account di origine. Selezionare Questo conto.

4. Selezionare Routing registri come servizio di origine. Quindi, impostare l'ambito dell'accesso su Tutte le risorse.

5. 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 di IBM Cloud Logs, o su una singola istanza configurando Risorse in base agli attributi selezionati > Istanza di servizio.

   Altri attributi non sono supportati per questo tipo di autorizzazione.

6. Nella sezione Accesso al servizio, selezionare Mittente per assegnare l'accesso al servizio di origine che accede al servizio di destinazione.

7. 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.

Configurare la posizione dei metadati primari e la versione dell'API

Completa i seguenti passi:

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione >Instradamento.

4. Fai clic sulla scheda Settings.

5. Fare clic su Modifica accanto all'impostazione da modificare.

   Inserire una posizione di metadati primaria.

   Impostare la versione API su 3.

Creare un obiettivo

Completare i seguenti passaggi per creare un target:

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Selezionare Registrazione > Instradamento.

4. Nella sezione Obiettivi, fare clic su Crea per aprire il pannello di creazione.

5. In Scegliere la destinazione, selezionare Cerca per istanza o Specifica CRN.

   Selezionare Cerca per istanza per scegliere un'istanza di IBM Cloud Logs dalla tabella disponibile nell'account

   Selezionare Specifica CRN per aggiungere il CRN dell'istanza IBM Cloud Logs di un'istanza che si trova in un account diverso.

6. Nella sezione Dettagli del target, completare le seguenti operazioni:

   Immettere il nome della destinazione.

   Attivare la levetta da Non impostato per impostare automaticamente il nuovo obiettivo come obiettivo predefinito nelle impostazioni di IBM Cloud Logs Routing.

7. Fare clic su Crea destinazione.

Configurare un percorso

Completare i seguenti passaggi per creare un target:

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione > Instradamento.

4. Nella scheda Percorsi, fare clic su Crea.

5. Nella sezione Regole di routing, modificare l' Azione per la Regola 1:

   Selezionare un' azione per la regola 1:

   • Selezionare Invia log da per la regola per instradare i log della piattaforma ai target associati.

   • Selezionare Elimina registri da per la regola per eliminare i registri della piattaforma che corrispondono a questa regola.

   Aggiungere i filtri di inclusione per determinare i log della piattaforma instradati verso le destinazioni specificate nella regola.

   • Selezionare una condizione e specificare i valori di posizione che il filtro di inclusione deve soddisfare.

   • Per aggiungere più filtri di inclusione, fare clic su Aggiungi filtro per aggiungere altri filtri.

   Aggiungere i target da associare alla regola selezionando un target dall'elenco. Se non è stato definito un target, fare clic su Aggiungi target per crearne uno nuovo.

6. Fare clic su Aggiungi regola per aggiungere ulteriori regole al percorso.

   L'ordine delle regole di percorso influisce sul comportamento del routing. Le regole vengono elaborate in ordine e una volta che una regola è stata soddisfatta, le regole successive non vengono elaborate.

   L'ordine delle regole di instradamento può essere modificato facendo clic sulle frecce in alto e in basso a destra di ogni definizione di regola.

   Per rimuovere una regola o un filtro, fare clic sull'icona Rimuovi associata alla regola o al filtro.

   È possibile configurare fino a 10 regole per ogni percorso.

7. Fai clic su Next.

8. Inserire un nome per il percorso.

9. Rivedere la definizione del percorso per verificare che l'ordine delle regole sia quello previsto.

   Per ulteriori informazioni, vedere Comprensione della precedenza di routing.

10. Fai clic su Crea.

Verifica dell'invio dei log alla destinazione di destinazione

Verificare che i registri siano indirizzati all'istanza IBM Cloud Logs.

Completa i seguenti passi:

1. Avviare l'interfaccia web IBM Cloud Logs per l'istanza IBM Cloud Logs configurata come target per la raccolta dei registri della piattaforma in una regione. Si tratta dell'istanza selezionata nel passaggio in cui si è impostato un target.

2. Visualizzare i registri attraverso viste personalizzate. Per ulteriori informazioni, vedi Visualizzazione dei log.

   Tutti i log della piattaforma sono generati in JSON. È possibile filtrare i log della piattaforma nella propria istanza selezionando il valore di ibm-platform-logs come applicationName o eseguendo la query Lucene: coralogix.metadata.applicationName:"ibm-platform-logs"