Abilitazione del monitoraggio delle metriche

Per ricevere le metriche di monitoraggio, devi configurare la tua istanza IBM Cloud Monitoring.

Per ricevere le metriche di monitoraggio, utilizza la seguente procedura:

1. Navigare nel portale di monitoraggio delle metriche e fare clic su Opzioni > Crea.

2. Selezionare una regione per l'istanza di IBM Cloud Monitoring.

   Se non hai un gateway VPN esistente, vedi Creazione di un gateway VPN per fornirne uno mediante provisioning.

   La regione deve corrispondere all'ubicazione del tuo gateway VPN esistente.

3. Scegli il tuo piano di prezzi.

   I dettagli del piano di prezzi sono spiegati nella finestra di selezione. Seleziona il piano che meglio soddisfa i tuoi requisiti.

4. Fornisci un nome servizio univoco per la tua istanza. Il nome può essere qualsiasi nome che desideri. Il nome non ha alcun impatto sulla funzionalità.

   Non dare a più istanze di IBM Cloud Monitoring lo stesso nome.

5. Facoltativamente, seleziona un gruppo di risorse. Un gruppo di risorse organizza le risorse dell'account nei raggruppamenti personalizzabili. Qualsiasi risorsa dell'account gestita tramite il controllo degli accessi di IBM Cloud® Identity and Access Management (IAM) appartiene a un gruppo di risorse all'interno dell'account.

   Se non hai alcun gruppo di risorse preconfigurato, o nessun motivo per condividere questa risorsa in modo selettivo, utilizza la selezione predefinita.

   Se il tuo account ha più gruppi di risorse, puoi scegliere quale gruppo ha accesso a questa istanza IBM Cloud Monitoring. Utilizzando questo accesso selettivo, le metriche possono essere disponibili per alcuni gruppi di risorse e non per altri.

6. Selezionare la casella di controllo Abilita. Devi selezionare questa opzione per ricevere le metriche dal tuo gateway VPN.

7. Fai clic su Crea. Vieni riportato alla home page delle metriche di monitoraggio.

In pochi minuti, la nuova istanza di IBM Cloud Monitoring viene visualizzata con diverse configurazioni. Potresti dover aggiornare il tuo browser per vederla.

Lavorare con il dashboard IBM Cloud Monitoring

Per visualizzare e lavorare con le metriche di IBM Cloud Monitoring, procedere come segue:

1. Navigare nel portale di monitoraggio delle metriche.

2. Fare clic su Apri dashboard accanto al nome del servizio dell'istanza di IBM Cloud Monitoring con cui si desidera lavorare.

   La prima volta che si accede all'istanza di IBM Cloud Monitoring, vengono visualizzate diverse finestre come parte della configurazione interna. Mantenere le voci predefinite e fare clic sulle pagine fino a raggiungere la pagina principale di IBM Cloud Monitoring.

3. Aprire il dashboard IBM VPN for VPC Monitoring Metrics selezionando Dashboards.

4. Fai clic su Dashboard Library> IBM > VPC VPN. Il dashboard predefinito non è modificabile.

5. Vengono visualizzate dieci metriche principali nel dashboard. Queste metriche includono lo stato di gateway/connessione, l'input/output di byte di gateway/connessione e l'input/output di pacchetti di gateway/connessione. Se vuoi modificare i parametri e segmentare le tue metriche in base al nome del gateway VPN e al nome della connessione VPN, devi creare un dashboard personalizzato.

   È possibile scegliere la finestra temporale in cui visualizzare le metriche utilizzando la barra di selezione del tempo.

Creazione di un dashboard di metriche personalizzate

Puoi creare un tuo dashboard per personalizzare le tue metriche di monitoraggio, come ad esempio la visualizzazione di informazioni su specifici gateway VPN o la visualizzazione del traffico che arriva attraverso una connessione VPN.

Per personalizzare il tuo dashboard, utilizza la seguente procedura:

1. Navigare nel portale di monitoraggio delle metriche.

2. Fare clic su Apri dashboard accanto al nome del servizio dell'istanza di IBM Cloud Monitoring con cui si desidera lavorare. Ora vedi il dashboard.

3. Seleziona Dashboards e fai clic su + nel pannello.

4. Seleziona Blank dashboard e seleziona il tipo di rappresentazione visiva che desideri.

   IBM Cloud Monitoring offre otto diverse visualizzazioni per il cruscotto. Leggi la descrizione per ogni visualizzazione, quindi scegli quella che meglio risponde ai tuoi requisiti.

   La linea Visualizza trend nel tempo è l'opzione più frequentemente selezionata. I seguenti esempi mostrano una visualizzazione basata sulla linea.

5. Configura il tuo dashboard personalizzato.

   • Nel campo Metriche, immettere ibm_is per visualizzare i dieci IBM Cloud VPN per le metriche VPC: ibm_is_vpn_gateway_status, ibm_is_vpn_connection_status, ibm_is_vpn_gateway_bytes_in, ibm_is_vpn_gateway_bytes_out, ibm_is_vpn_gateway_packets_in, ibm_is_vpn_gateway_packets_out, ibm_is_vpn_connection_bytes_in, ibm_is_vpn_connection_bytes_out, ibm_is_vpn_connection_packets_in, e ibm_is_vpn_connection_packets_out.

   • Puoi scegliere un ambito da visualizzare nel tuo dashboard facendo clic su Override Dashboard Scope. Ad esempio, puoi visualizzare le metriche per uno specifico gateway VPN.

   • Puoi anche impostare un segmento per confrontare le metriche nell'ambito che definisci. Ad esempio, puoi visualizzare lo stato della connessione per uno specifico gateway VPN segmentato in base al nome del gateway e della connessione.

6. Fare clic su Salva.

   Per impostazione predefinita, il dashboard è denominato "blank dashboard". È possibile modificare il nome selezionando Dashboard dalla barra laterale e facendo clic sull'icona Modifica accanto al nome.

Per tornare alla dashboard predefinita di IBM Cloud Monitoring in qualsiasi momento, selezionare Dashboard > Dashboard predefinite > IBM > VPC VPN.

Gestione di IBM Cloud Monitoring utilizzando le API

Puoi anche lavorare con l'istanza IBM Cloud Monitoring utilizzando le API di query delle metriche. È possibile utilizzare le API se si ha bisogno di punti di dati grezzi o se si desidera consumare le metriche da un'interfaccia a riga di comando piuttosto che utilizzare il dashboard IBM Cloud Monitoring.

Dopo aver creato la tua istanza IBM Cloud Monitoring, devi raccogliere le seguenti due informazioni.

• Il token API Monitor
• L'endpoint dell'istanza di IBM Cloud Monitoring

Per raccogliere queste informazioni e lavorare con l'istanza IBM Cloud Monitoring utilizzando l'API per le query metriche, procedere come segue:

1. Accedere alla Pagina iniziale di monitoraggio.

2. Fare clic su Apri dashboard accanto all'istanza con cui si desidera lavorare.

3. Una volta visualizzata la dashboard di IBM Cloud Monitoring, selezionare l'icona Profilo account nella barra laterale e selezionare Impostazioni. Ora vedi le impostazioni del tuo account.

4. Il token API Monitor è una stringa alfanumerica che si trova nel campo Sysdig Monitor API Token. Fai clic sul pulsante Copy per copiare il token nei tuoi appunti.

   Non condividere questo token dell'API. Chiunque disponga di questo token dell'API ha accesso completo alle tue metriche.

5. L'endpoint della tua istanza IBM Cloud Monitoring è per regione. Ad esempio, se la tua istanza IBM Cloud Monitoring esiste in us-south, il suo endpoint è:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

6. Quando disponi sia dell'endpoint che del token dell'API, puoi formattare la tua richiesta POST. La seguente richiesta POST è un esempio, con tutti i parametri che puoi modificare. Di seguito sono indicati i parametri:

   • Il token API Monitor.
   • L'endpoint dell'istanza di IBM Cloud Monitoring.
   • Il valore per ibm_is_vpn_gateway_name (il nome del gateway VPN per cui vuoi visualizzare le metriche).

   Se vuoi visualizzare questa metrica per tutti i tuoi gateway VPN, non immettere un valore per l'attributo scope. Ad esempio, utilizzare "scope" : "".

   • Il tipo di metrica per cui desideri visualizzare i risultati. Questo esempio utilizza ibm_is_vpn_gateway_status.
   • Gli attributi from e to definiscono il periodo di tempo sul quale focalizzare la scansione, impostati in tempo Epoch e in microsecondi.
   • Gli attributi sampling e value impostano la granularità dei dati restituiti nella richiesta POST.

   Poiché un grande volume di dati viene memorizzato in IBM Cloud Monitoring, scegliere il livello specifico di granularità è importante. IBM Cloud Monitoring può restituire solo 600 punti dati alla volta per richiesta. Di conseguenza, gli attributi sampling e value sono importanti. Lasciare queste due righe fuori dalla tua richiesta restituisce invece una somma aggregata su tale periodo di tempo.

   Se l'intervallo di tempo specificato da from e to è ampio (ad esempio, 4 giorni), ma si definiscono sampling e value di 10 secondi, significa che si ricevono dati di 4 giorni suddivisi in parti di 10 secondi. Questo esempio non è utile a causa della grande quantità di dati restituiti. È consigliata la specifica di una porzione più grande (ad esempio, 1 ora invece di 10 secondi).

      curl \
      -H 'Authorization: Bearer <API_TOKEN>’ \
      -H 'Content-Type: application/json' \
      https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
      -d '{
        "requests": [
            {
                "format": {
                    "type": "data"
                },
                "scope": "ibm_is_vpn_gateway_name = \"test-001\"",
                "metrics": {
                    "k0": "timestamp",
                    "v1": "ibm_is_vpn_gateway_status"
                },
                "time": {
                    "from": 1589877054000000,
                    "to": 1589877114000000,
                    "sampling": 60000000
                },
                "group": {
                    "by": [
                        {
                           "metric": "k0",
                            "value" : 60000000
                        }
                    ],
                    "aggregations": {
                        "v1": "avg"
                    },
                    "groupAggregations": {
                        "v1": "avg"
                    }
                }
            }
        ]
    }'
   

Gestione di IBM Cloud Monitoring utilizzando VPN for VPC UI

È possibile visualizzare le metriche dei singoli gateway VPN e lanciare il dashboard IBM Cloud Monitoring dall'interfaccia utente VPN.

1. Navigare nella UI VPN.

2. Fare clic sul nome di un gateway VPN di cui si desidera visualizzare le metriche di IBM Cloud Monitoring e accedere alla pagina Panoramica.

   Il pannello di anteprima del monitoraggio visualizza la somma di ogni metrica nell'ultima ora.

   È possibile fare clic su Avvia monitoraggio per avviare il dashboard predefinito del gateway VPN IBM Cloud Monitoring.

3. Aprire la pagina di monitoraggio del gateway VPN. La pagina visualizza la velocità effettiva e i pacchetti del gateway VPN in un intervallo di tempo.

   Allo stesso modo, è possibile avviare la dashboard predefinita del gateway VPN IBM Cloud Monitoring facendo clic su Avvia monitoraggio.