Você pode encaminhar logs do vRealize Automation para vRealize Log Insight para aproveitar as vantagens de uma análise de log e geração de relatórios mais avançadas.
O vRealize Automation acompanha um agente de registro em logbaseado em fluentd. Esse agente coleta e armazena logs para que estes possam ser incluídos em um pacote de logs e examinados posteriormente. Você pode configurar o agente para encaminhar uma cópia dos logs para um servidor vRealize Log Insight usando a REST API do vRealize Log Insight. A API permite que outros programas se comuniquem com o vRealize Log Insight.
Para obter mais informações sobre o vRealize Log Insight, incluindo a documentação da REST API do vRealize Log Insight, consulte Documentação do vRealize Log Insight.
Configure o agente de registro em log para encaminhar continuamente logs do vRealize Automation ao vRealize Log Insight usando o utilitário de linha de comando do vracli
fornecido.
Todas as linhas de log são marcadas com um nome de host, e a tag de ambiente e pode ser examinada no vRealize Log Insight. Em um ambiente de alta disponibilidade (HA), os logs são marcados com nomes de host diferentes, dependendo do nó em que foram originados. A tag de ambiente é configurável usando a opção --environment ENV
, conforme descrito abaixo na seção Configurar ou atualizar a integração do vRealize Log Insight. Em um ambiente de HA, a tag de ambiente tem o mesmo valor para todas as linhas de log, independentemente do nó em que se originaram.
Informações sobre como usar o utilitário de linha de comando vracli
estão disponíveis usando o argumento --help
na linha de comando vracli
. Por exemplo: vracli vrli --help
. Para obter uma resposta amigável, comece o comando com vracli -j vrli
.
Verificar a configuração existente do vRealize Log Insight
Commandvracli vrli
Não há argumentos de linha de comando.
OutputA configuração atual para a integração do vRealize Log Insight é gerada no formato JSON.
Exit codes- 0 - A integração com o vRealize Log Insight está configurada.
- 1 - Ocorreu uma exceção como parte da execução do comando. Examine a mensagem de erro para obter detalhes.
- 61 (ENODATA) -A integração com o vRealize Log Insight não está configurada. Examine a mensagem de erro para obter detalhes.
$ vracli vrli No vRLI integration configured $ vracli vrli { "agentId": "0", "environment": "prod", "host": "my-vrli.local", "port": 9543, "scheme": "https", "sslVerify": false }
Configurar ou atualizar a integração do vRealize Log Insight
Commandvracli vrli set [options] FQDN_OR_URL
- FQDN_OR_URL
Especifica o FQDN ou a URL do servidor vRealize Log Insight a ser usado para publicar logs. A porta 9543 e o https são usados por padrão. Se alguma dessas configurações precisar ser alterada, você poderá usar uma URL em vez disso.
vracli vrli set <options> https://FQDN:9543
Observação:Você pode definir um esquema de host diferente (o padrão é https) e uma porta diferente (o padrão para https é 9543, o padrão para http é 9000) a serem usados para enviar os logs, conforme mostrado nos seguintes exemplos:vracli vrli set https://HOSTNAME:9543 vracli vrli set --insecure HOSTNAME vracli vrli set http://HOSTNAME:9000
As portas 9543 para https e 9000 para http são usadas pela REST API de ingestão do vRealize Log Insight, conforme descrito em Administrando o vRealize Log Insight, tópico Portas e interfaces externas, na documentação do vRealize Log Insight.
- Opções
- --agent-id SOME_ID
Define o ID do agente de registro em log para esse dispositivo. O padrão é
0
. Usado para identificar o agente ao publicar logs no vRealize Log Insight usando a REST API vRealize Log Insight. - --environment ENV
Define um identificador para o ambiente atual. Ele estará disponível nos logs do vRealize Log Insight como uma tag para entrada de log. O padrão é
prod
. - --ca-file /path/to/server-ca.crt
Especifica um arquivo que contém o certificado da autoridade de certificação (CA) que foi usado para assinar o certificado do servidor vRealize Log Insight. Isso força o agente de registro em log a confiar na CA especificada e permite que ele verifique se o certificado do servidor vRealize Log Insight foi assinado por uma autoridade não confiável. O arquivo pode conter uma cadeia de certificados inteira para verificar o certificado. No caso de um certificado autoassinado, transmita o certificado propriamente dito.
- --ca-cert CA_CERT
A definição é idêntica à de --ca-file, como acima, mas, em vez disso, transmite o certificado (cadeia) em linha como uma string.
- --insecure
Desativa a verificação SSL do certificado do servidor. Isso força o agente de registro em log a aceitar qualquer certificado SSL ao publicar logs.
- --agent-id SOME_ID
- Opções avançadas
- --request-max-size BYTES
Vários eventos de log são ingeridos com uma única chamada de API. Esse argumento controla o tamanho máximo da carga útil, em bytes, para cada solicitação. Os valores válidos estão entre 4000 e 4000000. O valor padrão é 256000. Para obter informações relacionadas aos valores permitidos, consulte o tópico sobre ingestão de eventos do vRealize Log Insight na documentação da REST API do vRealize Log Insight. Definir esse valor como um nível muito baixo pode fazer com que os eventos de log maiores que o tamanho permitido sejam descartados.
- --request-timeout SECONDS
Uma chamada para a API pode travar por vários motivos, incluindo problemas com o aspectos remotos, problemas de rede e assim por diante. Esse parâmetro controla o número de segundos de espera para a conclusão de cada operação, como abrir uma conexão, gravar dados ou aguardar uma resposta, antes que a chamada seja reconhecida como falha. O valor não pode ser inferior a 1 segundo. O padrão é 30.
- --request-immediate-retries RETRIES
Os logs são armazenados em blocos agregados antes de serem enviados ao vRealize Log Insight (consulte --buffer-flush-thread-count abaixo). Se uma solicitação de API falhar, o log será repetido imediatamente. O número padrão de novas tentativas imediatas é 3. Se nenhuma das novas tentativas for bem-sucedida, o fragmento inteiro de log será revertido e repetido novamente mais tarde.
- --request-http-compress
Para volumes mais baixos de tráfego de rede, você pode aplicar a compactação gzip às solicitações enviadas ao servidor do vRealize Log Insight. Se esse parâmetro não for especificado, nenhuma compactação será usada.
- --buffer-flush-thread-count THREADS
Para melhorar o desempenho e limitar o tráfego de rede, os logs são armazenados em buffer localmente em fragmentos antes de serem liberados e enviados ao servidor de log. Cada fragmento contém logs de um único serviço. Dependendo do seu ambiente, esses fragmentos podem ficar grandes e demorados de liberar. Esse argumento controla o número de fragmentos que podem ser liberados simultaneamente. O padrão é 2.
- --request-max-size BYTES
Ao configurar a integração por https, se o servidor do vRealize Log Insight estiver configurado para usar um certificado não confiável, como um certificado autoassinado ou um certificado que foi assinado por uma autoridade não confiável, você deverá usar uma das opções --ca-file
, --ca-cert
ou --insecure
. Caso contrário, o agente de log falhará ao validar a identidade do servidor e não enviará logs. Ao usar --ca-file
ou --ca-cert
, o certificado do servidor do vRealize Log Insight deve ser válido para o nome do host do servidor. Em todos os casos, verifique a integração, permitindo alguns minutos para o processamento e, em seguida, verificando se o vRealize Log Insight recebeu os logs.
Nenhuma saída é esperada.
Exit codes- 0 - A configuração foi atualizada.
- 1 - Ocorreu uma exceção como parte da execução. Examine a mensagem de erro para obter detalhes.
vracli vrli set {somehost}
ou
vracli vrli set --ca-file path/to/server-ca.crt
para modificar a ID do agente padrão ou os valores do ambiente. Para obter informações relacionadas, consulte a ajuda do comando online em
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
Apagar a integração do vRealize Log Insight
Commandvracli vrli unset
Não há argumentos de linha de comando.
OutputA confirmação é emitida em formato de texto simples.
Exit codes- 0 - A configuração foi apagada ou não existia uma configuração.
- 1 - Ocorreu uma exceção como parte da execução. Examine a mensagem de erro para obter detalhes.
$ vracli vrli unset Clearing vRLI integration configuration $ vracli vrli unset No vRLI integration configured