Creazione di un connettore con un'origine di log

• 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 Log.
  5. In Destinazione selezionare il servizio in cui si desidera trasferire i dati di log:
     • Funzioni: inviare i dati di log a una funzione.
     • Logging Analytics: inviare i dati di log a un gruppo di log.
     • Monitoraggio: inviare i dati di log ai datapoint metrica al servizio di monitoraggio.
     • Notifiche: inviare i dati di log a un argomento.
     • Storage degli oggetti: invia i dati di log a un bucket.
     • Streaming: inviare i dati di log 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 il log di origine.
     • 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.
  8. (Facoltativo) In Task filtro log, immettere i valori per filtrare il gruppo di log e il log selezionati.

     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.
  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.

  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.
  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 con un'origine di log:

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<logging_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 log, inserire i dettagli di log in source nella richiesta (CreateServiceConnectorDetails). Per un esempio, vedere LoggingSourceDetails.