Prerequisiti

• Installa la CLI IBM Cloud.

• Installa la CLI IBM Cloud Metrics Routing.

• Devi avere un id utente con autorizzazioni per gestire IBM Cloud Metrics Routing. Per ulteriori informazioni sui ruoli IAM e su come assegnarli, vedi Gestione dell'accesso con IAM e Assegnazione dell'accesso a IBM Cloud Metrics Routing.

• Per configurare IBM Cloud Metrics Routing per instradare metriche a una istanza Monitoring, devi configurare un servizio per l'autorizzazione del servizio. Non devi fornire credenziali a IBM Cloud Metrics Routing.

  Per informazioni sulla configurazione del servizio per l'autenticazione servizio, consultare Gestione delle autorizzazioni per concedere l'accesso tra i servizi.

Passo 1. Configurare le impostazioni dell'account

Configura queste impostazioni dell'account per definire dove e come le metriche vengono raccolte, instradate e gestite nel tuo account utilizzando IBM Cloud Metrics Routing.

Quando configuri IBM Cloud Metrics Routing nel tuo account, puoi configurare le impostazioni dell'account come le posizioni dei metadati, il tipo di endpoint a cui è consentito gestire la configurazione, le ubicazioni in cui possono essere definite le destinazioni e le destinazioni predefinite per la raccolta delle metriche nelle regioni che non hai configurato esplicitamente come instradare le metriche. Per ulteriori informazioni, vedi Configurazione delle impostazioni dell'account IBM Cloud Metrics Routing.

Prima di poter configurare le destinazioni e le rotte nell'account, è necessario configurare la posizione dei metadati primari che definisce la regione in cui sono memorizzate tutte le definizioni delle risorse IBM Cloud Metrics Routing.

Eseguire il seguente comando per configurare l'ubicazione dei metadati primari:

ibmcloud metrics-router setting update --primary-metadata-region <REGION>

Dove <REGION> è impostato su una regione supportata dove IBM Cloud Metrics Routing è disponibile. Per ulteriori informazioni, vedi Ubicazioni.

Prima di impostare l'ubicazione dei metadati, verificare eventuali normative di conformità o di settore che si applicano all'ubicazione dei dati.

Passo 2. Configura 1 destinazione

Una destinazione definisce dove vengono raccolte le metriche. Per ulteriori informazioni sulle destinazioni, vedi Understanding how targets work in your account.

Quando configuri una destinazione, stai definendo la destinazione a cui intendi inviare le metriche della piattaforma raccolte in una regione nel tuo account.

Completare i seguenti passaggi per configurare un target:

1. Definire una destinazione in cui instradare le metriche.

   ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
   

   Dove

   --name

   Definisce il nome da assegnare alla destinazione.

   --destination-crn

   Definisce il CRN dell'istanza IBM Cloud Monitoring in cui intendi instradare le metriche. Le destinazioni IBM Cloud Monitoring sono le uniche supportate.

   --region

   [Facoltativo] Definisce la regione in cui viene creata la definizione di destinazione. È possibile specificare solo una regione supportata. Impostare questa opzione se si desidera creare una destinazione in una regione e si è connessi a una diversa.

2. Definisci un'autorizzazione da servizio a servizio tra il servizio IBM Cloud Metrics Routing e l'istanza IBM Cloud Monitoring che hai configurato come tua destinazione nella destinazione. Per ulteriori informazioni, vedi Gestione delle autorizzazioni per concedere l'accesso tra i servizi.

Passo 3. Configura 1 instradamento

Un instradamento definisce le regole che indicano quali metriche vengono instradate in una regione e dove memorizzarle. Le rotte sono globali in un account e vengono valutate in tutte le regioni in cui viene distribuito IBM Cloud Metrics Routing. Per ulteriori informazioni, vedi Descrizione del funzionamento degli instradamenti nel tuo account.

In questo passo, configurerai un instradamento per reindirizzare le metriche alla destinazione configurata nel passo precedente.

Eseguire il seguente comando per creare il percorso:

ibmcloud metrics-router route create --name ROUTE_NAME  --rules RULES

Dove

--name ROUTE_NAME

Definisce il nome da assegnare all'instradamento.

--rules RULES

Definisce una definizione di regola formattata JSON racchiusa tra singoli apici. Ulteriori informazioni.

Dopo aver configurato un instradamento, l'abilitazione della configurazione potrebbe richiedere fino a 1 ora.

Ad esempio, per creare un instradamento per l'invio delle metriche generate in us - east alla destinazione che hai creato nel passo precedente, esegui questo comando.

ibmcloud metrics-router route create --name "my-route" --rules '[{"action": "send", "targets":[{"id":"TARGETID"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-east"}]}]''

Dove TARGETID è l'ID del target creato nel passaggio precedente.

Passo 4. Verifica raccolta di metriche

Dopo aver configurato la destinazione e l'instradamento, è necessario verificare che le metriche siano disponibili.

Avvia l'IU IBM Cloud Monitoring per l'istanza Monitoring che hai configurato come tua destinazione e esplora le metriche.

In alternativa, è possibile utilizzare i moduli Terraform IBM(TIM) precostituiti, open-source e pronti per l'impresa per IBM Cloud Monitoring per configurare target, rotte e impostazioni dell'account. Questo modulo semplifica la creazione e la gestione di target e rotte secondo le migliori pratiche.