Creazione di un connettore con un'origine di monitoraggio

[
  {
    "namespace":"oci_computeagent",
    "compartmentId":"ocid1.tenancy.oc1..exampleuniqueID",
    "name":"DiskBytesRead",
    "dimensions":{
      "resourceId":"ocid1.instance.region1.phx.exampleuniqueID"
    },
    "metadata":{
      "unit":"bytes"
    }
  },
  "datapoints":[
    {
      "timestamp":"2022-03-10T22:19:00Z",
      "value":10.4
    },
    {
      "timestamp":"2022-03-10T22:20:00Z",
      "value":11.3
    }
  ]
]

• Console
• CLI
• API

• 1. Nella pagina di elenco Connettori, selezionare Crea connettore. Per informazioni su come trovare la pagina dell'elenco, vedere Elenco dei connettori.
  2. Nella pagina Crea connettore, immettere un nome riconoscibile dall'utente per il nuovo connettore e una descrizione facoltativa. Evitare di inserire informazioni riservate.
  3. Selezionare il compartimento in cui memorizzare il nuovo connettore.
  4. In Configura connettore, in Origine selezionare Monitoraggio.
  5. Per Destinazione, selezionare il servizio in cui si desidera trasferire i datapoint della metrica:
     • Funzioni: inviare i datapoint delle metriche a una funzione.
     • Storage degli oggetti: invia i datapoint delle metriche a un bucket.
     • Streaming: invia i datapoint delle metriche a un flusso.
  6. (Facoltativo) Per abilitare i log di servizio per il nuovo connettore, selezionare lo switch Log e fornire i valori riportati di seguito.
     • Categoria log: il valore Tracciamento connettore viene selezionato automaticamente.
     • Compartimento: selezionare il compartimento che si desidera memorizzare i log del servizio per il connettore.
     • Gruppo di log: selezionare il gruppo di log desiderato per la memorizzazione dei log del servizio. Per creare un nuovo gruppo di log, selezionare Crea nuovo gruppo, quindi immettere un nome.
     • Nome log: è possibile immettere un nome per il log.
     • Mostra opzioni avanzate:
       • Conservazione log: è possibile specificare per quanto tempo conservare i log del servizio (impostazione predefinita: 30 giorni).
  7. In Configura connessione di origine selezionare la metrica di origine:
     • Compartimento metrica: selezionare il compartimento contenente le metriche desiderate.
     • Spazi di nomi: selezionare uno o più spazi di nomi delle metriche che includono le metriche desiderate. Vengono recuperate tutte le metriche negli spazi di nomi selezionati.

       Gli spazi di nomi devono iniziare con "oci_". Esempio: oci_computeagent.

     • Per aggiungere spazi di nomi delle metriche da un altro compartimento, selezionare + Altro compartimento.

       Il numero massimo di compartimenti di metriche per ogni origine di monitoraggio è 5. Il numero massimo di spazi di nomi per ogni origine di monitoraggio (in tutti i compartimenti delle metriche) è 50. Di seguito sono riportati alcuni set di compartimenti di esempio in un'unica origine che rimangono entro questo massimo:

       • 5 compartimenti di metriche con 10 spazi dei nomi ciascuno
       • 3 compartimenti metrici con numeri diversi di spazi dei nomi (20, 20, 10)
       • 1 compartimento metrico con 50 spazi di nomi
  8. (Facoltativo) In Configura task funzione, configurare un task funzione per elaborare i datapoint delle metriche utilizzando il servizio Funzioni:
     • Seleziona task: selezionare Funzione.
     • Compartimento: selezionare il compartimento contenente la funzione desiderata.
     • Applicazione funzione: selezionare il nome dell'applicazione funzione che include la funzione desiderata.
     • Funzione: selezionare il nome della funzione che si desidera utilizzare per elaborare i dati ricevuti dall'origine.

       Per essere utilizzata dal connettore come task, la funzione deve essere configurata in modo da restituire una delle seguenti risposte:

       • Lista di voci JSON (deve impostare l'intestazione di risposta Content-Type=application/json)
       • Voce JSON singola (deve impostare l'intestazione di risposta Content-Type=application/json)
       • Oggetto binario singolo (deve impostare l'intestazione di risposta Content-Type=application/octet-stream)
     • Mostra opzioni aggiuntive: selezionare questo collegamento e specificare i limiti per ogni batch di dati inviato alla funzione. Per utilizzare le impostazioni manuali, fornire i valori per il limite di dimensione batch (KB) e il limite di tempo batch (secondi).

     Considerazioni per i task funzione:

     • L'hub connettore non analizza l'output del task funzione. L'output del task funzione viene scritto così com'è nella destinazione. Ad esempio, quando si utilizza una destinazione Notifiche con un task funzione, tutti i messaggi vengono inviati come BLOB JSON di tipo RAW.
     • Le funzioni vengono richiamate in modo sincrono con 6 MB di dati per richiamo. Se i dati superano i 6 MB, il connettore richiama di nuovo la funzione per spostare i dati oltre il limite. Tali richiami vengono gestiti in sequenza.
     • Le funzioni possono essere eseguite per un massimo di cinque minuti. Vedere Dettagli consegna.
     • Le funzioni sono limitate alle funzioni scalari.
  9. Se si seleziona Funzioni come destinazione, in Configura destinazione configurare la funzione a cui inviare i datapoint della metrica. Quindi, andare al passo 13.
     • Compartimento: selezionare il compartimento contenente la funzione desiderata.
     • Applicazione funzione: selezionare il nome dell'applicazione funzione contenente la funzione desiderata.
     • Funzione: selezionare il nome della funzione a cui si desidera inviare i dati.
     • Mostra opzioni aggiuntive: selezionare questo collegamento e specificare i limiti per ogni batch di dati inviato alla funzione. Per utilizzare le impostazioni manuali, fornire i valori per il limite di dimensione batch (KB o numero di messaggi) e il limite di tempo batch (secondi).

       Ad esempio, limitare la dimensione del batch selezionando 5.000 kilobyte o 10 messaggi. Un limite di tempo batch di esempio è di 5 secondi.

     Considerazioni per le destinazioni delle funzioni:

     • Il connettore svuota i dati di origine come lista JSON in batch. La dimensione massima del batch, o payload, è di 6 MB.
     • Le funzioni vengono richiamate in modo sincrono con 6 MB di dati per richiamo. Se i dati superano i 6 MB, il connettore richiama di nuovo la funzione per spostare i dati oltre il limite. Tali richiami vengono gestiti in sequenza.
     • Le funzioni possono essere eseguite per un massimo di cinque minuti. Vedere Dettagli consegna.
     • Non restituire i dati dalle destinazioni Funzioni ai connettori. Connector Hub non legge i dati restituiti dalle destinazioni Functions.
  10. Se come destinazione è stato selezionato Storage degli oggetti, in Configura destinazione configurare il bucket a cui inviare i datapoint della metrica. Quindi, andare al passo 13.
      • Compartimento: selezionare il compartimento contenente il bucket desiderato.
      • Bucket: selezionare il nome del bucket a cui si desidera inviare i dati.
      • Prefisso nome oggetto: è possibile immettere un valore di prefisso.
      • Mostra opzioni aggiuntive: selezionare questo collegamento e, facoltativamente, immettere i valori per la dimensione batch (in MB) e il tempo batch (in millisecondi).

      Considerazioni per le destinazioni dello storage degli oggetti:

      • Dettagli rinnovo batch:

        • Dimensione rollover batch: 100 MB
        • Tempo di rollover batch: 7 minuti

      • I file salvati nello storage degli oggetti vengono compressi utilizzando gzip.

      • Formato dei dati spostati da un'origine di monitoraggio: oggetti. Le partizioni del connettore eseguono l'origine dei dati dal servizio di monitoraggio in base allo spazio di nomi delle metriche e scrivono i dati per ogni gruppo (spazio di nomi) in un oggetto. Ogni nome oggetto include i seguenti elementi.

        <object_name_prefix>/<service_connector_ocid>/<metric_compartment_ocid>/<metric_namespace>/<data_start_timestamp>_<data_end_timestamp>.<sequence_number>.<file_type>.gz

        All'interno di un oggetto, ogni set di datapoint viene aggiunto a una nuova riga.

  11. Se come destinazione è stata selezionata l'opzione Streaming, in Configura destinazione configurare il flusso a cui inviare i datapoint della metrica.
      Nota
      
      Per selezionare un pool di flussi e un flusso per un connettore, è necessario disporre dell'autorizzazione per leggere il pool di flussi e il flusso. Vedere Policy IAM (Securing Connector Hub). La configurazione dell'endpoint privato è supportata. Per utilizzare un endpoint privato, vedere Prerequisiti degli endpoint privati per Streams.

      • Compartimento: selezionare il compartimento contenente il flusso desiderato.
      • Via: selezionare il nome del flusso a cui si desidera inviare i dati.

      Considerazioni per le destinazioni di streaming:

      • Formato di dati spostati da un'origine di monitoraggio: ogni oggetto viene scritto come messaggio separato.
  12. Per accettare i criteri predefiniti, selezionare il collegamento Crea fornito per ogni criterio predefinito.

      I criteri predefiniti vengono offerti per consentire a questo connettore di accedere ai servizi di origine, task e destinazione.

      È possibile ottenere questa autorizzazione mediante questi criteri predefiniti o mediante criteri basati su gruppi. I criteri predefiniti vengono offerti ogni volta che si utilizza la console per creare o modificare un connettore. L'unica eccezione è quando il criterio esatto esiste già in IAM, nel qual caso il criterio predefinito non viene offerto. Per ulteriori informazioni su questo requisito di autorizzazione, vedere Autenticazione e autorizzazione.

      • Se non si dispone delle autorizzazioni per accettare i criteri predefiniti, contattare l'amministratore.
      • I criteri creati automaticamente rimangono quando vengono eliminati i connettori. Si consiglia di eliminare i criteri associati quando si elimina il connettore.

      Per rivedere un criterio appena creato, selezionare il collegamento vista associato.

  13. (Facoltativo) Aggiungere una o più tag al connettore: selezionare Mostra opzioni avanzate per visualizzare la sezione Aggiungi tag.
      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
  14. Selezionare Crea.

  Il processo di creazione inizia e ne viene visualizzato l'avanzamento. Al termine, viene visualizzata la pagina dei dettagli del connettore.

• Utilizzare il comando oci sch service-connector create e i parametri richiesti per creare un connettore con un'origine di monitoraggio:

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<metrics_source_in_JSON>] --target [<target_in_JSON>]

  Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.

• Eseguire l'operazione CreateServiceConnector per creare un connettore.

  Per creare un connettore con un'origine di monitoraggio, inserire i dettagli di monitoraggio in source nella richiesta (CreateServiceConnectorDetails). Per un esempio, vedere MonitoringSourceDetails.