Obiettivi

In questa esercitazione si apprende quanto segue:

• Configurare IBM Cloud Logs Routing per instradare i log della piattaforma a un'istanza di IBM Cloud Logs in una regione.

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

Prima di iniziare

Completa i seguenti passi:

1. Rivedere About IBM® Cloud Logs Routing per comprendere i concetti.

2. Installare tutti gli strumenti prerequisiti come descritto nella sezione Iniziare.

3. Per ottenere dettagli su un tenant utilizzando l'API, verificare che sia possibile connettersi a IBM Cloud Logs Routing utilizzando l'API di gestione. Per ulteriori informazioni, vedi Connessione a IBM® Cloud Logs Routing.

4. I registri della piattaforma indirizzati a IBM Cloud Logs includono campi di metadati che si possono usare per gestire i dati e configurare le funzioni nella propria istanza IBM Cloud Logs.

   Il nome dell'applicazione è l'ambiente che produce e invia i registri a IBM Cloud Logs. I log della piattaforma hanno il nome dell'applicazione impostato su ibm-platform-log.

   Il nome del sottosistema è il servizio o l'applicazione che produce e invia i log o le metriche a IBM Cloud Logs. I log della piattaforma hanno il nome del sottosistema impostato su CRNserviceName:instanceID. Per i log della piattaforma VPC, i campi sono impostati su is:resourceType.

5. Impostare le autorizzazioni per la gestione degli obiettivi nell'account. Per ulteriori informazioni, vedi Concessione delle autorizzazioni IAM.

   Prima di poter impostare il servizio IBM Cloud Logs Routing per instradare i log della piattaforma, occorre un token di accesso IBM Cloud® Identity and Access Management (IAM) per l'autenticazione. Per ottenere queste informazioni si utilizza la CLI IBM Cloud.

   1. Esegui l'accesso al tuo account IBM Cloud. Includere l'opzione --sso se si utilizza un ID federato.

      ibmcloud login [--sso]
      

      L'output includerà il vostro nome utente, simile a:

      Targeted account Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
      
      
       API endpoint:     https://cloud.ibm.com
       Region:           us-south
       User:             Jane.Doe@ibm.com
       Account:          Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
       Resource group:   No resource group targeted, use 'ibmcloud target -g RESOURCE_GROUP'
      

   2. Per concedere l'accesso all'uso di IBM Cloud Logs Routing al proprio utente, raccogliere il nome utente dall'output generato sopra. Nel nostro esempio, questo sarebbe Jane.Doe@ibm.com. Sostituite <username> con il vostro nome utente nel comando seguente:

      ibmcloud iam user-policy-create <username> --roles Manager --service-name logs-router
      

      Invece di assegnare i ruoli direttamente alle identità, una strategia comune è quella di assegnare i ruoli ai gruppi di accesso e aggiungere le identità come membri a tali gruppi di accesso. Per ulteriori informazioni sui gruppi di accesso, vedere Impostazione dei gruppi di accesso.

Creazione di un'autorizzazione da servizio a servizio

È necessario usare IBM Cloud® Identity and Access Management (IAM) per creare un'autorizzazione che conceda IBM Cloud Logs Routing l'accesso a IBM Cloud Logs.

Recuperare le informazioni di IBM Cloud Logs

Per instradare i dati a un'istanza IBM Cloud Logs, sono necessarie informazioni sulla destinazione in cui si desidera che vengano consegnati i log. Per l'istanza di IBM Cloud Logs sono necessarie le seguenti informazioni:

• L'istanza CRN
• L'endpoint e la porta di ingestione (ingress)

Utilizzare questo comando per recuperare l' URL e e l'ID:

ibmcloud resource service-instances --service-name logs --long --output JSON | jq '[.[] | {name: .name, id: .id, region: .region_id, ingestion_endpoint: .extensions.external_ingress}]'

Se si dispone di più istanze, scegliere quella che si desidera utilizzare per ricevere i registri della piattaforma e salvare le informazioni per un secondo momento.

Il punto finale è simile a:

ingestion_endpoint: 3a622101-7521-4002-bf91-8c26e17eedcf.ingress.eu-de.logs.cloud.ibm.com

L'ID è simile a:

"crn:v1:bluemix:public:logs:eu-es:a/15ff25632a21af53a2aeed19a1542a44:3a622101-7521-4002-bf91-8c26e17eedcf::"

Per ottenere tutte le informazioni sull'istanza, è possibile eseguire ibmcloud resource service-instances --service-name logs --long --output JSON Questo comando elenca tutte le istanze IBM Cloud Logs. Sono necessari i seguenti campi: ID che contiene il CRN dell'istanza, extensions.external_ingress che contiene l'endpoint di ingresso e extensions.virtual_private_endpoints.endpoints.ports.port_max che contiene il valore della porta.

Creazione di un inquilino e di un obiettivo

Per ricevere i registri della piattaforma, è necessario creare un tenant con il servizio IBM Cloud Logs Routing.

È necessario creare il tenant nella regione in cui si desidera raccogliere e instradare i log della piattaforma all'istanza IBM Cloud Logs.

curl -X POST https://<MANAGEMENT-API-ENDPOINT>:443/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H 'IBM-API-Version: DATE' \
--data '{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_ID",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": PORT
            }
        }
    ]
}'

{
    "id": "3517d2ed-9429-af34-ad52-34278391cbc8:",
    "created_at": "2023-10-20T18:30:00.143156Z",
    "updated_at": "2023-10-20T18:30:00.143156Z",
    "crn": "crn:v1:bluemix:public:logs-router:eu-de:a/3516b8fa0a174a71899f5affa4f18d78:3517d2ed-9429-af34-ad52-34278391cbc8::",
    "name": "tenant",
    "etag": "\"822b4b5423e225206c1d75666595714a11925cd0f82b229839864443d6c3c049\"",
    "targets": [
    {
        "id": "86432b-66a6-df12-7003-888a21a2b3",
        "log_sink_crn": "crn:v1:bluemix:public:logs:eu-gb:a/91d1d1e42f9b684df920bbd06461c222:743e3b4f-72bc-4669-9fa6-0e6621d0b232::",
        "name": "my-log-sink",
        "etag": "\"c3a43545a7f2675970671ac3a57b8db067a1866b2222e1b950ee8da612e347c6\"",
        "type": "logs",
        "created_at": "2023-10-20T18:30:00.143156Z",
        "updated_at": "2023-10-20T18:30:00.143156Z",
        "parameters": {
            "host": "743e3b4f-72bc-4669-9fa6-0e6621d0b232.ingress.eu-gb.logs.cloud.ibm.com",
            "port": 443
        }
    }
    ]
}

Verifica dell'invio dei log alla destinazione di destinazione

Per assicurarsi che i registri della piattaforma fluiscano correttamente verso IBM Cloud Logs, eseguire le seguenti operazioni:

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

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 registri della piattaforma nella propria istanza selezionando il valore di ibm-platform-logs come applicationName.