Informazioni sulle destinazioni

È possibile gestire i target Monitoring nel proprio account utilizzando l'interfaccia utente IBM Cloud Metrics Routing, la CLI IBM Cloud Metrics Routing, l'API REST IBM Cloud Metrics Routing e il provider IBM Cloud Metrics Routing Terraform. Un obiettivo è una risorsa in cui è possibile raccogliere metriche. La risorsa può trovarsi nello stesso account IBM Cloud in cui vengono generate le metriche o in un account diverso.

Come funzionano le destinazioni nel tuo account

Si notano le seguenti informazioni sulle destinazioni:

Le destinazioni sono regionali in un account e possono essere accessibili da qualsiasi endpoint API IBM Cloud Metrics Routing regionale.
Puoi definire una destinazione in qualsiasi delle ubicazioni supportate in cui è disponibile IBM Cloud Metrics Routing. Per ulteriori informazioni, vedi Ubicazioni.
È possibile configurare fino a 16 destinazioni in ogni account.
Puoi configurare fino a due destinazioni predefinite per ogni account IBM Cloud.

Le destinazioni predefinite raccolgono le metriche dalle ubicazioni in cui non si specifica nell'account dove instradare le metriche generate in tale ubicazione.
Le informazioni sulle destinazioni vengono memorizzate come metadati nelle ubicazioni primaria e di backup che hai impostato per l'account IBM Cloud. Le informazioni memorizzate includono i dettagli sulla risorsa di destinazione e sulle credenziali per inviare le metriche.

L'ubicazione dei metadati primari deve essere impostata prima di configurare una destinazione.

Se non configuri un'ubicazione dei metadati primari, l'ubicazione viene impostata sull'ubicazione in cui definisci la tua prima destinazione nell'account. Per ulteriori informazioni, vedi Configurazione delle impostazioni dell'account.
È possibile utilizzare endpoint privati e pubblici per gestire le destinazioni. Per ulteriori informazioni sull'elenco di endpoint disponibili, vedi Endpoint.
- È possibile gestire le destinazioni dalla rete privata utilizzando un endpoint API con il formato seguente: https://private.REGION.metrics-router.cloud.ibm.com
- È possibile gestire le destinazioni dalla rete pubblica utilizzando un endpoint API con il formato seguente: https://REGION.metrics-router.cloud.ibm.com
- È possibile disabilitare gli endpoint pubblici aggiornando le impostazioni di account. Per ulteriori informazioni, vedi Applicazione degli endpoint privati.
Il nome della destinazione deve essere di massimo 1000 caratteri e non può includere caratteri speciali diversi da spazio, trattino -, punto ., trattino basso _ e due punti :.

Il nome non deve includere informazioni di identificazione personale (PII).

Tipi di destinazione

È possibile configurare uno dei seguenti tipi di target:

Elenco degli obiettivi
Destinazione	Immettere	Ambito	Descrizione
IBM Cloud Monitoring	`sysdig-monitor`	`Account`	Utilizzare questa destinazione per consolidare i dati delle serie temporali nella region delle operazioni principali.

Accesso IAM

Per gestire le destinazioni, assicurati di disporre delle autorizzazioni IAM corrette per configurare IBM Cloud Metrics Routing.

Per consentire al servizio IBM Cloud Metrics Routing di inviare metriche alle tue destinazioni Monitoring, devi disporre di un servizio per l'autorizzazione del servizio configurato nell'account in cui si trova la destinazione. Per ulteriori informazioni, vedi Gestione delle autorizzazioni per concedere l'accesso tra i servizi.

Autorizzazioni IAM

La seguente tabella elenca le azioni IAM, il loro ambito e i ruoli richiesti per gestire le rotte.

Scopi di azione e ruoli IAM per la gestione degli obiettivi
Attività	Azione IAM	Ambito politica IAM	Ruoli IAM
Crea una destinazione	`metrics-router.target.create`	Regione	`Administrator` `Editor`
Elenca tutte le destinazioni	`metrics-router.target.list`	Account	`Administrator` `Editor` `Operator` `Viewer`
Ottenere i dettagli di un obiettivo	`metrics-router.target.read`	Regione	`Administrator` `Editor` `Operator` `Viewer`
Modifica una destinazione	`metrics-router.target.update`	Regione	`Administrator` `Editor`
Elimina una destinazione	`metrics-router.target.delete`	Regione	`Administrator` `Editor`

Quando utilizzi la CLI, nota che hai bisogno del ruolo metrics-router.target.list per creare, leggere, aggiornare o eliminare una destinazione.

Controllo degli eventi

La seguente tabella elenca le azioni IAM, il loro ambito e i ruoli richiesti per gestire le rotte.

Tracciamento delle attività, auditing, azione degli eventi
Attività	Tracciamento delle attività, auditing, azione degli eventi
Crea una destinazione	`metrics-router.target.create`
Elenca tutte le destinazioni	`metrics-router.target.list`
Ottenere i dettagli di un obiettivo	`metrics-router.target.read`
Modifica una destinazione	`metrics-router.target.update`
Elimina una destinazione	`metrics-router.target.delete`

Gestione dei target tramite l'interfaccia utente

È possibile gestire la definizione del target utilizzando l'interfaccia utente IBM Cloud Metrics Routing. Per ulteriori informazioni, vedere Gestione dei target.

Prerequisiti CLI

Prima di utilizzare la CLI per gestire le destinazioni, completare la seguente procedura:

Assicurati di disporre delle autorizzazioni IAM corrette per configurare IBM Cloud Metrics Routing.
Installa la CLI IBM Cloud.
Installa la CLI IBM Cloud Metrics Routing.

Comandi della CLI

La tabella seguente elenca le azioni che si possono eseguire per gestire i target:

Azioni mirate
Azione	Comando
`Create a target`	`ibmcloud metrics-router target create`
`Update a target`	`ibmcloud metrics-router target update`
`Delete a target`	`ibmcloud metrics-router target rm`
`Read a target`	`ibmcloud metrics-router target get`
`List all targets`	`ibmcloud metrics-router target ls`

Per ulteriori informazioni, vedi IBM Cloud Metrics Routing v3 CLI.

Prerequisiti API

Prima di utilizzare l'API per gestire le destinazioni, completa la seguente procedura:

Assicurati di disporre delle autorizzazioni IAM corrette per configurare IBM Cloud Metrics Routing.
Ottenere un token di accesso IAM. Per ulteriori informazioni, vedi Richiamo dei token di accesso IAM.
Identifica l'endpoint API nella regione in cui intendi configurare o gestire una destinazione. Per ulteriori informazioni, vedi Endpoint.

Metodi API

La tabella seguente elenca le azioni che si possono eseguire per gestire i target:

Azioni mirate utilizzando il IBM Cloud Metrics Routing API REST
Azione	Metodo API REST	URL API
`Create a target`	`POST`	`<ENDPOINT>/api/v3/targets`
`Update a target`	`PATCH`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Delete a target`	`DELETE`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Read a target`	`GET`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`List all targets`	`GET`	`<ENDPOINT>/api/v3/targets`

Per ulteriori informazioni, vedi APIIBM Cloud Metrics Routing v3.

Codici di risposta HTTP

Quando si utilizza l'API REST di IBM Cloud Metrics Routing, è possibile ottenere i codici di risposta standard di HTTP per indicare se un metodo è stato completato con successo.

Una risposta 200 indica sempre l'esito positivo.
Una risposta 4xx indica un errore.
Una risposta 5xx di solito indica un errore interno del sistema.

Vedere la tabella seguente per alcuni codici di risposta di HTTP:

Elenco dei codici di risposta HTTP
Codice di stato	Condizione	Descrizione
`200`	OK	La richiesta ha avuto esito positivo.
`201`	OK	La richiesta ha avuto esito positivo. Viene creata una risorsa.
`204`	OK	La destinazione è stata eliminata con successo.
`400`	Richiesta non valida	La richiesta ha avuto esito negativo. Potrebbe mancare un parametro obbligatorio.
`401`	Non autorizzato	La richiesta di autorizzazione ha esito negativo.
`403`	Non consentito	L'operazione non è consentita a causa di autorizzazioni insufficienti.
`404`	Non trovato	La risorsa richiesta non esiste o è già stata eliminata.
`429`	Troppe richieste	Troppe richieste hanno raggiunto l'API troppo rapidamente.
`500`	Errore interno del server	Si è verificato un problema nell'elaborazione di IBM Cloud Metrics Routing.