Documentazione di Oracle Cloud Infrastructure

Creazione di una configurazione agente

Creare una configurazione agente in Log per includere eventi dalle applicazioni in un log personalizzato.

Per creare una configurazione agente, è necessario prima installare l'agente basato su fluentd Oracle. Per informazioni dettagliate, vedere Installazione dell'agente.

    1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Log, selezionare Configurazioni agente.
    2. In Ambito elenco, selezionare un compartimento in cui si dispone dell'autorizzazione per lavorare.
    3. Selezionare Crea configurazione agente.
    4. Nel pannello Crea configurazione agente immettere un nome e una descrizione per la configurazione. Evitare di inserire informazioni riservate.
    5. Selezionare il compartimento in cui si desidera creare la configurazione.
    6. In Gruppi di host, in cui è possibile definire le VM da applicare a questa configurazione, selezionare una delle seguenti opzioni dalla lista Tipo di gruppo:
      • Gruppo dinamico: Gruppo dinamico si riferisce a un gruppo di istanze che è possibile creare nella funzione IAM della console. Per ulteriori informazioni, vedere Informazioni sui gruppi dinamici. Selezionare un gruppo dinamico dalla lista Gruppo.
      • Gruppo di utenti: il gruppo di utenti fa riferimento alla funzione Gruppi IAM della console. Per ulteriori informazioni, vedere Gestione dei gruppi. Selezionare un gruppo di utenti dalla lista Gruppo.
    7. Per aggiungere altri gruppi, selezionare + Altro gruppo host.

      È possibile aggiungere una combinazione di tipi di gruppo per la configurazione dell'agente.

      Nota

      È consentito un massimo di cinque gruppi per configurazione e un host può essere incluso in un massimo di cinque gruppi diversi.
    8. In Configurazione agente, definire il formato dei log (log che si desidera controllare) in Configura input di log. Selezionare una delle opzioni dall'elenco Tipo di input:
      • In Log eventi Windows, immettere un nome di input e selezionare uno o più canali evento.
      • Per Percorso log, immettere un nome di input e uno o più percorsi file. Ad esempio, /<log_path>/<log_name>.

      È possibile specificare più percorsi di file di log separati da una virgola (,). Per ulteriori informazioni, vedere https://docs.fluentd.org/input/tail#path.

      <source>
@type tail
tag 757261.oc_oslogs_linux
path /var/log/.log,/var/log/.out,/var/log/dmesg,var/log/grubby,/var/log/messages*,
 var/log/secure,/var/log/auth,/var/log/acpid,/root/.bash_history
pos_file /etc/unifiedmonitoringagent/pos/757261-oc_oslogs_linux.pos
path_key tailed_path
</source>
      Configurazione di esempio
      {{path C:\Program Files (x86)\<application>\<directory>*, 
 C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}
    9. Selezionare Opzioni parser avanzate e, nel pannello Opzioni parser avanzate, selezionare un parser per specificare come analizzare il log. Alcuni parser richiedono ulteriore input e hanno più opzioni, a seconda del tipo scelto.
      Ad esempio, per JSON, è necessario selezionare un valore Tipo di ora dall'elenco, mentre facoltativamente è possibile specificare le impostazioni dell'ora dell'evento e del campo nullo. Per REGEXP, è possibile specificare l'espressione regolare per i log corrispondenti, insieme al formato dell'ora. Per ulteriori informazioni, vedere Log degli input e dei parser.
      Importante

      Il tipo di parser NONE è obbligatorio anche se non si desidera specificare un determinato tipo di parser.
    10. In Seleziona destinazione log, il gruppo di utenti o il gruppo dinamico nella configurazione selezionata nel compartimento deve disporre dell'autorizzazione per lavorare nel compartimento.

      Selezionare il gruppo di log e il nome di log dagli elenchi corrispondenti.

      Il nome log può puntare solo a un log personalizzato e il log personalizzato deve esistere nel gruppo di log scelto affinché la configurazione funzioni.

    11. (Facoltativo) Selezionare Mostra opzioni aggiuntive. In Metriche operative agente di log, selezionare Abilita per facilitare il monitoraggio e l'identificazione dei potenziali problemi con l'agente.
      In Emetti destinazione, selezionare il compartimento e specificare uno spazio di nomi e, facoltativamente, specificare il gruppo di risorse dai campi corrispondenti.
      Nota

      Sebbene Gruppo di risorse sia facoltativo, il valore predefinito è "defaultGroup" se non è selezionato alcun elemento.
      In Metriche operative selezionare le metriche operative che si desidera abilitare per la configurazione dell'agente.
      • Heartbeat: stato dell'agente di monitoraggio unificato. Il valore 1 indica che l'agente è disponibile e il valore 0 indica che l'agente non risponde. Questa metrica è sempre abilitata e non può essere disattivata.

        Dimensioni: versione dell'agente di monitoraggio unificato dell'istanza, sistema operativo, architettura, area, AD e ID istanza.

      • RestartMetric: a differenza della metrica Heartbeat, periodica, RestartMetric viene inviato una sola volta durante la durata dell'agente, ovvero quando l'agente viene riavviato. I riavvii del monitoraggio sono essenziali per comprendere la stabilità dell'agente. I riavvii frequenti possono indicare malfunzionamenti del sistema e la consapevolezza di riavvii imprevisti può aiutare gli operatori a risolvere i problemi di configurazione o i vincoli delle risorse.

        Dimensioni: ID istanza.

      • EmitRecords: il numero totale di record di log emessi. Un record corrisponde alle righe di log inviate al backend. Questa metrica fornisce informazioni dettagliate sull'aumento e la diminuzione del numero di righe di log incluse e del volume di log in fase di elaborazione. Un improvviso calo o aumento di questo numero può segnalare problemi nella pipeline di log. Ad esempio, alcune righe di log potrebbero essere rifiutate e non incluse durante l'inclusione dei log.

        Dimensioni: ID istanza e tag.

      • BufferSpaceAvailable: lo spazio del buffer disponibile espresso in percentuale. Il valore inizia da 100 e diminuisce man mano che viene utilizzato l'importo del buffer. L'agente utilizza i buffer per gestire i burst dei dati in entrata e la potenziale backpressure dagli output. Il monitoraggio di questa metrica aiuta a garantire che non si esaurisca lo spazio del buffer, il che potrebbe portare a perdita di dati o pressione negativa. Se lo spazio nel buffer è costantemente ridotto, potrebbe essere necessario ottimizzare la configurazione dell'agente e allocare più risorse.

        Dimensioni: ID istanza e tag.

      • ShowFlushCount: il numero totale di svuotamenti lenti. Flush si riferisce all'atto di inviare i dati inseriti nel buffer alla destinazione desiderata. Un flush lento significa che lo svuotamento dei dati dal buffer alla destinazione richiede più tempo della soglia impostata. Questo numero viene incrementato quando lo svuotamento del buffer dura più di 20 secondi. Il monitoraggio di svuotamenti lenti consente di identificare i problemi relativi alle prestazioni. Se i flush sono costantemente lenti, il buffer può riempirsi più velocemente di quanto i dati possano essere cancellati, causando perdita di dati o problemi di backpressure.

        Dimensioni: ID istanza e tag.

      • RollbackCount: il numero totale di volte in cui l'agente esegue il rollback di una transazione perché non è stato possibile scaricare correttamente il buffer nella destinazione di emissione. I rollback si verificano in genere quando una scrittura o try_write non riesce o sono presenti problemi con il servizio di log OCI, problemi di rete o problemi di configurazione. I conteggi elevati dei rollback sono un chiaro indicatore di problemi di affidabilità nella pipeline di log che richiedono un'indagine.

        Dimensioni: ID istanza e tag.

      • RetryCount: tiene traccia del numero di tentativi di un'operazione di invio dati da parte dell'agente dopo un errore. I nuovi tentativi indicano problemi transitori nella consegna dei dati e un numero elevato di nuovi tentativi può indicare l'instabilità della rete. Sebbene i rollback possano gestire problemi transazionali più grandi, i tentativi spesso indicano interruzioni più piccole, probabilmente più frequenti.

        Dimensioni: ID istanza e tag.

      Dopo aver creato la configurazione dell'agente, è possibile visualizzare le metriche operative abilitate quando si ottengono i dettagli di una configurazione dell'agente.

    12. (Facoltativo) Aggiungere una o più tag alla configurazione dell'agente: selezionare Mostra opzioni aggiuntive 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.
    13. (Facoltativo) Selezionare Salva come stack per salvare la configurazione della risorsa come stack.
      Per ulteriori informazioni, vedere Creazione di uno stack da una pagina di creazione di risorse.
    14. Selezionare Crea.
    La configurazione dell'agente viene creata e visualizzata nella pagina Configurazioni agente.

  • Utilizzare il comando oci logging agent-configuration create e i parametri necessari per creare una configurazione dell'agente per il log.

    oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

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

  • Eseguire l'operazione CreateUnifiedAgentConfiguration per creare una configurazione agente per il log.