Per sfruttare i vantaggi dell'analisi dei registri e della generazione di report più robusti, è possibile inoltrare i registri da VMware Aria Automation a VMware Aria Operations for Logs.
VMware Aria Automation contiene un agente di registrazione basato su fluentd. L'agente raccoglie e archivia i registri in modo che possano essere inclusi in un bundle di registri ed esaminati in un secondo momento. L'agente può inoltrare una copia dei registri a un server VMware Aria Operations for Logs utilizzando la REST API di VMware Aria Operations for Logs. L'API consente agli altri programmi di comunicare con VMware Aria Operations for Logs.
Per ulteriori informazioni su VMware Aria Operations for Logs, inclusa la documentazione relativa alla REST API, vedere la documentazione di VMware Aria Operations for Logs.
Per inoltrare tutti i registri di VMware Aria Automation a VMware Aria Operations for Logs, utilizzare i comandi di configurazione vracli.
È possibile esaminare ogni riga dei registri in VMware Aria Operations for Logs. Ogni riga di registro contiene un nome host e un tag environment . In un ambiente ad alta disponibilità (HA), i registri contengono tag con nomi host diversi, in base al nodo in cui vengono originati. Il tag environment è configurabile utilizzando l'opzione --environment ENV come descritto nella sezione Configurazione o aggiornamento dell'integrazione di VMware Aria Operations for Logs. In un ambiente ad alta disponibilità (HA), il tag environment ha lo stesso valore per tutte le righe dei registri.
Per visualizzare informazioni su come utilizzare l'utilità della riga di comando vracli, utilizzare l'argomento --help nella riga di comando vracli. Ad esempio vracli vrli --help. Per una risposta semplice, iniziare il comando con vracli -j vrli.
syslog.
Controllare la configurazione esistente di VMware Aria Operations for Logs
Commandvracli vrli
Non sono presenti argomenti della riga di comando.
OutputLa configurazione corrente per l'integrazione di VMware Aria Operations for Logs viene restituita in formato JSON.
Exit codes- 0: l'integrazione con VMware Aria Operations for Logs è configurata.
- 1: si è verificato un errore di eccezione. Per dettagli, esaminare il messaggio di errore.
- 61: l'integrazione con VMware Aria Operations for Logs non è configurata. Per dettagli, esaminare il messaggio di errore.
$ vracli vrli
No vRLI integration configured
$ vracli vrli
{
"agentId": "0",
"environment": "prod",
"host": "my-vrli.local",
"port": 9543,
"scheme": "https",
"sslVerify": false
}
Configurazione o aggiornamento dell'integrazione di VMware Aria Operations for Logs
Commandvracli vrli set [options] FQDN_OR_URL
- FQDN_OR_URL
Specifica l'indirizzo FQDN o l'indirizzo URL del server di VMware Aria Operations for Logs da utilizzare per la pubblicazione dei registri. Per impostazione predefinita, vengono utilizzate la porta 9543 e HTTPS. Se è necessario modificare una di queste impostazioni, è possibile utilizzare un URL.
vracli vrli set <options> https://FQDN:9543
Nota:È possibile impostare uno schema host (il valore predefinito è HTTPS) e una porta (il valore predefinito per HTTPS è 9543, il valore predefinito per HTTP è 9000) diversi da utilizzare per l'invio dei registri, come illustrato negli esempi seguenti:vracli vrli set https://HOSTNAME:9543 vracli vrli set --insecure HOSTNAME vracli vrli set http://HOSTNAME:9000
Le porte 9543 per HTTP e 9000 per HTTP vengono utilizzate dalla REST API di inserimento di VMware Aria Operations for Logs come descritto nell'argomento Amministrazione di VMware Aria Operations for Logs della sezione Porte e interfacce esterne nella documentazione di VMware Aria Operations for Logs.
- Opzioni
- --agent-id SOME_ID
Imposta l'ID dell'agente di registrazione per questa appliance. Il valore predefinito è
0. Utilizzato per identificare l'agente durante la pubblicazione dei registri in VMware Aria Operations for Logs tramite la REST API di VMware Aria Operations for Logs. - --environment ENV
Imposta un identificatore per l'ambiente corrente. Sarà disponibile nei registri di VMware Aria Operations for Logs come tag per ogni voce di registro. Il valore predefinito è
prod. - --ca-file /path/to/server-ca.crt
Specifica un file che contiene il certificato dell'autorità di certificazione (CA) utilizzata per firmare il certificato del server di VMware Aria Operations for Logs. In questo modo l'agente di registrazione considera attendibile l'autorità di certificazione specificata e la abilita alla verifica del certificato del server di VMware Aria Operations for Logs se è stato firmato da un'autorità non attendibile. Il file può contenere un'intera catena di certificati per verificare il certificato. Nel caso di un certificato autofirmato, passare il certificato stesso.
- --ca-cert CA_CERT
La definizione è identica a quella di --ca-file precedente, ma al contrario passa il certificato (catena) inline come stringa.
- --insecure
Disattiva la verifica SSL del certificato del server. Di conseguenza, forza l'agente di registrazione in modo che accetti qualsiasi certificato SSL durante la pubblicazione dei registri.
- --agent-id SOME_ID
- Opzioni avanzate
- --request-max-size BYTES
Più eventi di registro vengono acquisiti con una singola chiamata API. Questo argomento controlla la dimensione massima del payload, in byte, per ogni richiesta. I valori validi sono compresi tra 4000 e 4000000. Il valore predefinito è 256000. Per informazioni correlate ai valori consentiti, vedere Acquisizione degli eventi di VMware Aria Operations for Logs nella documentazione della REST API di VMware Aria Operations for Logs. Se si imposta questa opzione su un valore troppo basso, è possibile che gli eventi di registrazione che superano le dimensioni consentite vengano rimossi.
- --request-timeout SECONDS
Una chiamata all'API può bloccarsi per una serie di motivi, tra cui problemi di rete, remoti e così via. Questo parametro controlla il numero di secondi di attesa per il completamento di ciascuna operazione, ad esempio l'apertura di una connessione, la scrittura di dati o l'attesa di una risposta, prima che la chiamata venga riconosciuta come non riuscita. Il valore non può essere inferiore a 1 secondo. Il valore predefinito è 30.
- --request-immediate-retries RETRIES
Viene eseguito il buffering dei registri in blocchi aggregati prima che vengano inviati a VMware Aria Operations for Logs (vedere --buffer-flush-thread-count di seguito). Se una richiesta API non riesce, il registro viene ripetuto immediatamente. Il numero predefinito di tentativi immediati è 3. Se nessuno dei tentativi ha esito positivo, l'intero blocco di registri viene sottoposto a rollback e viene ripetuto nuovamente in un secondo momento.
- --request-http-compress
Per ridurre i volumi di traffico di rete, è possibile applicare la compressione GZIP alle richieste inviate al server VMware Aria Operations for Logs. Se questo parametro non viene specificato, non viene utilizzata alcuna compressione.
- --buffer-flush-thread-count THREADS
Per migliorare le prestazioni e limitare il traffico di rete, viene eseguito il buffering locale dei registri in blocchi prima che vengano scaricati e inviati al server dei registri. Ogni blocco contiene i registri di un singolo servizio. In base all'ambiente in cui si trovano, i blocchi possono aumentare notevolmente e richiedere molto tempo per lo scaricamento. Questo argomento controlla il numero di blocchi che possono essere scaricati simultaneamente. Il valore predefinito è 2.
- --request-max-size BYTES
Quando si configura l'integrazione tramite HTTPS, se il server di VMware Aria Operations for Logs è configurato per l'utilizzo di un certificato non attendibile, ad esempio un certificato autofirmato o un certificato firmato da un'autorità non attendibile, è necessario utilizzare una delle opzioni --ca-file, --ca-cert o --insecure oppure l'agente di registrazione non riesce a convalidare l'identità del server e non invia i registri. Quando si utilizza --ca-file o --ca-cert, il certificato del server di VMware Aria Operations for Logs deve essere valido per il nome host del server. In tutti i casi, verificare l'integrazione attendendo alcuni minuti per il completamento dell'elaborazione e controllando che VMware Aria Operations for Logs abbia ricevuto i registri.
Non è previsto alcun output.
Exit codes- 0: la configurazione è stata aggiornata.
- 1: si è verificata un'eccezione come parte dell'esecuzione. Per dettagli, esaminare il messaggio di errore.
vracli vrli set {somehost} o
vracli vrli set --ca-file path/to/server-ca.crt per modificare l'ID dell'agente predefinito o i valori dell'ambiente. Per informazioni correlate, vedere la guida in linea del comando qui:
vracli vrli --help.
$ vracli vrli set my-vrli.local $ vracli vrli set 10.20.30.40 $ vracli vrli set --ca-file /etc/ssl/certs/ca.crt 10.20.30.40 $ vracli vrli set --ca-cert "$(cat /etc/ssl/certs/ca.crt)" 10.20.30.40 $ vracli vrli set --insecure http://my-vrli.local:8080 $ vracli vrli set --agent-id my-vrli-agent my-vrli.local $ vracli vrli set --request-http-compress $ vracli vrli set --environment staging my-vrli.local $ vracli vrli set --environment staging --request-max-size 10000 --request-timeout 120 --request-immediate-retries 5 --buffer-flush-thread-count 4 my-vrli.local
Integrazione chiara di VMware Aria Operations for Logs
Commandvracli vrli unset
Non sono presenti argomenti della riga di comando.
OutputLa conferma viene emessa in formato testo normale.
Exit codes- 0: la configurazione è stata cancellata o non esisteva alcuna configurazione.
- 1: si è verificata un'eccezione come parte dell'esecuzione. Per dettagli, esaminare il messaggio di errore.
$ vracli vrli unset Clearing vRLI integration configuration $ vracli vrli unset No vRLI integration configured
