Creazione di un connettore

• 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. Selezionare il servizio Origine contenente i dati che si desidera trasferire:
     • Log: trasferisci i dati di log dal servizio di log. Vedere Log.
     • Monitoraggio: trasferire i datapoint delle metriche dal servizio di monitoraggio. Vedere Monitoring.
     • Coda: consente di trasferire i messaggi da una coda nel servizio. Vedere Coda.
     • Streaming: trasferisci i dati del flusso dal servizio di streaming. Vedere Streaming.
  5. In Destinazione selezionare il servizio a cui si desidera trasferire i dati:
     • Funzioni: inviare i dati a una funzione.
     • Logging Analytics: invia i dati a un gruppo di log.
     • Monitoraggio: inviare i datapoint metrica al servizio di monitoraggio.
     • Notifiche: inviare i dati a un argomento.
     • Storage degli oggetti: invia i dati a un bucket.
     • Streaming: invia i dati 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 immettere i valori per l'origine selezionata.

     Log

     • Nome compartimento: compartimento contenente il log desiderato.
     • Gruppo di log: il gruppo di log che contiene il log desiderato.

       Per lo schema di input del log, vedere LogEntry.

     • Log: il log desiderato. Per filtrare i log visualizzati in questo campo, vedere il passo successivo.

     Monitoraggio

     • 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

     Coda

     • Compartimento: selezionare il compartimento contenente la coda desiderata.
     • Coda: selezionare la coda che contiene i messaggi che si desidera.
       Nota
       
       Per selezionare una coda per un connettore, è necessario disporre dell'autorizzazione per leggere la coda. Vedere Policy IAM (Securing Connector Hub).

     • Filtro canale (in Filtro messaggi) (facoltativo): per filtrare i messaggi dai canali nella coda, immettere un valore.

       Ad esempio, per filtrare i messaggi in base all'ID canale, immettere l'ID canale.

       Per i valori supportati, vedere channelFilter all'indirizzo GetMessages (API coda).

     Nota
     
     Un messaggio trasferito alla destinazione del connettore viene considerato "consumato". Per soddisfare i requisiti del servizio Coda, il connettore elimina i messaggi trasferiti dalla coda di origine. Per ulteriori informazioni, vedere Utilizzo dei messaggi.

     Streaming

     Nota
     
     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.
     • Pool di flusso: selezionare il pool di flusso che contiene il flusso desiderato.
       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).
     • Via: selezionare il nome del flusso da cui si desidera ricevere i dati.
     • Posizione lettura: specificare la posizione del cursore da cui iniziare a leggere il flusso.
       • Ultimo: inizia a leggere i messaggi pubblicati dopo la creazione del connettore.
         • Se la prima esecuzione di un nuovo connettore con questa configurazione riesce, i dati vengono spostati dall'ora di creazione del connettore. Se la prima esecuzione non riesce (ad esempio con criteri mancanti), dopo la risoluzione il connettore sposta i dati dall'ora di creazione del connettore o, se l'ora di creazione non rientra nel periodo di conservazione, i dati disponibili meno recenti nel flusso. Ad esempio, si consideri un connettore creato alle 10 del mattino per un flusso con un periodo di conservazione di due ore. Se le esecuzioni non riuscite vengono risolte alle 11 del mattino, il connettore sposta i dati dalle 10 del mattino. Se le esecuzioni non riuscite vengono risolte alle 1 del pomeriggio, il connettore sposta i dati disponibili meno recenti nel flusso.
         • Le esecuzioni successive spostano i dati dalla posizione successiva nel flusso. Se un'esecuzione successiva non riesce, dopo la risoluzione il connettore sposta i dati dalla posizione successiva nel flusso o i dati disponibili meno recenti nel flusso, a seconda del periodo di conservazione del flusso.
       • Orizzonte percorso: inizia la lettura dal messaggio disponibile meno recente nel flusso.
         • Se la prima esecuzione di un nuovo connettore con questa configurazione riesce, i dati vengono spostati dai dati disponibili meno recenti nel flusso. Se la prima esecuzione non riesce (ad esempio con criteri mancanti), dopo la risoluzione il connettore sposta i dati disponibili meno recenti nel flusso, indipendentemente dal periodo di conservazione del flusso.
         • Le esecuzioni successive spostano i dati dalla posizione successiva nel flusso. Se un'esecuzione successiva non riesce, dopo la risoluzione il connettore sposta i dati dalla posizione successiva nel flusso o i dati disponibili meno recenti nel flusso, a seconda del periodo di conservazione del flusso.

  8. (Facoltativo) In Task filtro log (disponibile per l'origine Log), immettere i valori per filtrare i log.

     Per specificare i valori degli attributi per i log di audit (_Audit):

     • Tipo di filtro: selezionare Attributo.
     • Nome attributo: selezionare l'attributo del log di audit desiderato.
     • Valori attributo: specificare i valori per l'attributo log di audit selezionato.

     Per specificare gli eventi per i log di audit (_Audit):

     • Tipo di filtro: selezionare Tipo di evento.
     • Nome servizio: selezionare il servizio che contiene l'evento desiderato.
     • Tipo di evento: selezionare l'evento desiderato.

     Per specificare i valori delle proprietà per i log del servizio o i log personalizzati (non _Audit):

     • Proprietà: selezionare la proprietà desiderata.
     • Operatore: selezionare l'operatore da utilizzare per i valori delle proprietà filtro.
     • Valore: specificare il valore di proprietà desiderato.

     Per esaminare le query supportate per filtrare i log di origine, vedere Riferimento query di log per hub connettore.

  9. (Facoltativo) In Configura task funzione, configurare un task funzione per elaborare i dati dall'origine 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.
  10. Se si seleziona Funzioni come destinazione, in Configura destinazione configurare la funzione a cui inviare i dati di log. Quindi, andare al passo 17.
      • 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.
  11. Se come destinazione è stato selezionato Logging Analytics, in Configura destinazione configurare il gruppo di log a cui inviare i dati di log. Quindi, andare al passo 17.
      • Compartimento: selezionare il compartimento contenente il gruppo di log desiderato.
      • Gruppo di log: selezionare il gruppo di log desiderato.
      • Identificativo origine log (solo per l'origine di streaming): selezionare l'origine log.
  12. Se come destinazione è stato selezionato Monitoraggio, in Configura destinazione configurare la metrica a cui inviare i dati di log. Quindi, andare al passo 17.
      • Compartimento: selezionare il compartimento contenente la metrica desiderata.
      • Spazio di nomi metrica: selezionare gli spazi di nomi metrica che includono la metrica desiderata. È possibile selezionare uno spazio di nomi esistente o immettere un nuovo spazio di nomi.

        Quando si digita un nuovo spazio di nomi, premere Invio per sottometterlo.

        Per un nuovo spazio di nomi di metrica, non utilizzare il prefisso oci_ riservato. Le metriche non vengono incluse quando si utilizzano prefissi riservati. Vedere Pubblicazione delle metriche personalizzate e PostMetricData Reference (API).

      • Metrica: selezionare il nome della metrica a cui si desidera inviare i dati. È possibile selezionare una metrica esistente o immetterne una nuova.

        Quando si digita un nuovo nome di metrica, premere Invio per sottometterlo.

        Per una nuova metrica, non utilizzare il prefisso oci_ riservato. Le metriche non vengono incluse quando si utilizzano prefissi riservati. Vedere Pubblicazione delle metriche personalizzate e PostMetricData Reference (API).

      • Aggiungi dimensioni: selezionare questo pulsante per configurare facoltativamente le dimensioni. Viene visualizzato il pannello Aggiungi dimensioni.

        Le sei righe più recenti dei dati di log vengono recuperate dal log specificato in Configura origine.

        Specificare una coppia di chiavi nome-valore per ogni dimensione a cui si desidera inviare i dati. Il nome può essere personalizzato e il valore può essere statico o un percorso da valutare. Utilizzare le dimensioni per filtrare i dati dopo lo spostamento dei dati di log in una metrica. Per un caso d'uso della dimensione di esempio, vedere Scenario: Creazione di dimensioni per una destinazione di monitoraggio.

        Per estrarre i dati (valore del percorso)

        1. In Seleziona percorso, selezionare la freccia giù corrispondente al log desiderato.

           Per il log espanso vengono elencati i percorsi.

        2. Selezionare la casella di controllo per il percorso desiderato.

           L'immagine seguente mostra un esempio di percorso selezionato (bucketName) e di percorso non selezionato (eTag):

           

           In Modifica percorso i campi Nome dimensione e Valore vengono popolati automaticamente dal percorso selezionato.

           Se non sono disponibili dati di log, è possibile immettere manualmente un valore di percorso con un nome dimensione personalizzato in Modifica percorso. Il percorso deve iniziare con logContent, utilizzando la notazione punto (.) o indice ([]). Il punto e l'indice sono gli unici selettori JMESPath supportati. Ad esempio:

           • logContent.data (notazione punto)
           • logContent.data[0].content (notazione dell'indice)

           Per ulteriori informazioni sulla notazione di percorso valida, vedere JmesPathDimensionValue.

        3. È possibile modificare il nome della dimensione.

        A contrassegnare i dati (valore statico)

        • In Valori statici selezionare + Altro valore statico, quindi immettere un nome e un valore per la dimensione. Ad esempio, immettere traffic e customer.

      Nota
      
      Per le nuove metriche (personalizzate), lo spazio di nomi e la metrica specificati vengono creati la prima volta che il connettore sposta i dati dall'origine al servizio di monitoraggio. Per verificare l'esistenza di dati spostati, eseguire una query sulla nuova metrica utilizzando la console, l'interfaccia CLI o l'API. Vedere Creazione di una query per una metrica personalizzata.

      Elementi inclusi nella metrica

      Oltre alle coppie chiave nome-valore dimensione specificate in Configura dimensioni, con la metrica vengono incluse le dimensioni riportate di seguito.

      • connectorId: l'OCID del connettore al quale si applicano le metriche.
      • connectorName: il nome del connettore al quale vengono applicate le metriche.
      • connectorSourceType: il servizio di origine a cui si applicano le metriche.

      L'indicatore orario di ogni datapoint della metrica corrisponde all'indicatore orario del messaggio di log corrispondente.

  13. Se come destinazione è stata selezionata l'opzione Notifiche, in Configura destinazione configurare l'argomento a cui inviare i dati di log. Quindi, andare al passo 17.
      • Compartimento: selezionare il compartimento contenente l'argomento desiderato.
      • Argomento: selezionare il nome dell'argomento a cui si desidera inviare i dati.
      • Formato messaggio: selezionare l'opzione desiderata.
        Nota
        
        Le opzioni Formato messaggio sono disponibili solo per i connettori con origine di log. Queste opzioni non sono disponibili per i connettori con task funzione. Quando le opzioni Formato messaggio non sono disponibili, i messaggi vengono inviati come BLOB JSON di tipo RAW.
        • Invia messaggi formattati: layout semplificato e intuitivo.

          Per visualizzare i protocolli di sottoscrizione e i tipi di messaggio supportati per i messaggi formattati, vedere Formattazione descrittiva.

        • Invia messaggi raw: blob JSON raw.

      Considerazioni per le destinazioni delle notifiche:

      • La dimensione massima dei messaggi per la destinazione Notifiche è di 128 KB. Qualsiasi messaggio che supera la dimensione massima viene eliminato.
      • I messaggi SMS mostrano risultati imprevisti per determinate configurazioni del connettore. Questo problema è limitato agli argomenti che contengono sottoscrizioni SMS per le configurazioni connettore indicate. Per ulteriori informazioni, vedere Più messaggi SMS per una singola notifica.
  14. Se come destinazione è stato selezionato Storage degli oggetti, in Configura destinazione configurare il bucket a cui inviare i dati di log. Quindi, andare al passo 17.
      • 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.

  15. Se come destinazione è stata selezionata l'opzione Streaming, in Configura destinazione configurare il flusso a cui inviare i dati di log.
      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.
  16. 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.

  17. (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.
  18. 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:

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<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.