Criando uma Configuração do Agente

• Console
• CLI
• API

• 1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. Em Registro em Log, clique em Configuração do Agente.
  2. Em Escopo da lista, selecione um compartimento no qual você tenha permissão para trabalhar.
  3. Clique em Criar configuração do agente.
  4. No painel Criar configuração do agente, digite um nome e uma descrição para a configuração. Evite digitar informações confidenciais.
  5. Selecione o compartimento no qual você deseja criar a configuração.
  6. Em Grupos de Hosts, onde você define quais VMs se aplicam a essa configuração, selecione uma das seguintes opções na lista Tipo de grupo:
     • Grupo dinâmico: Grupo dinâmico refere-se a um grupo de instâncias que você pode criar no recurso IAM da Console. Para obter mais informações, consulte Sobre Grupos Dinâmicos. Selecione um grupo dinâmico na lista Grupo.
     • Grupo de usuários: Grupo de usuários refere-se ao recurso Grupos do serviço IAM da Console. Para obter mais informações, consulte Gerenciando Grupos. Selecione um grupo de usuários na lista Grupo.
  7. Para adicionar grupos, clique em + Outro grupo de hosts.

     Você pode adicionar uma combinação de tipos de grupo para a configuração do agente.

     Observação
     
     É permitido um máximo de cinco grupos por configuração, e um host pode estar em, no máximo, cinco grupos distintos.
  8. Em Configuração do agente, defina o formato dos logs (que logs você deseja ver) em Configurar entradas de log. Selecione uma das opções na lista Tipo de entrada:
     • Para log de eventos do Windows, informe um nome de entrada e selecione um ou mais canais de eventos.
     • Para Caminho de log, informe um nome de entrada e um ou mais caminhos de arquivo. Por exemplo, /<log_path>/<log_name>.

     Você pode especificar vários caminhos de arquivo de log, separados por vírgula (,). Para obter mais informações, consulte 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>

     Exemplo de configuração:

     {{path C:\Program Files (x86)\<application>\<directory>*, 
      C:\Program Files (x86)\<application>\<application_logs_directory>\<directory>* }}

  9. Clique em Opções avançadas do parser e, no painel Opções avançadas do parser, selecione um parser para especificar como fazer parsing do log. Alguns parsers exigem entrada adicional e têm mais opções, dependendo do tipo escolhido.
     Por exemplo, para JSON, você deve selecionar um valor de Tipo de tempo na lista, mas, opcionalmente, você pode especificar a hora do evento e definições de campo nulo. Para REGEXP, você pode especificar a expressão regular para logs correspondentes, juntamente com o formato de hora. Para obter mais informações, consulte Entradas de Log e Analisadores.

     Importante
     
     O tipo de parser NONE é obrigatório, mesmo que você não queira especificar um tipo de parser específico.
  10. Em Selecionar destino do log, o grupo de usuários ou o grupo dinâmico na configuração selecionada em Compartimento precisa ter permissão para trabalhar no compartimento.

      Selecione o Grupo de Logs e o Nome do log nas listas correspondentes.

      O Nome do log só pode apontar para um log personalizado, e o log personalizado deve existir no grupo de logs escolhido para a configuração funcionar.

  11. (Opcional) Clique em Mostrar opções adicionais. Em Métricas operacionais do agente de log, clique em Ativar para ajudar a monitorar e identificar possíveis problemas com o agente.
      Em Emitir destino, selecione o compartimento e especifique um namespace e, opcionalmente, especifique o grupo de recursos nos campos correspondentes.

      Observação
      
      Embora o Grupo de recursos seja opcional, ele assumirá "defaultGroup" como padrão se nada for selecionado.

      Em Métricas operacionais, selecione as métricas operacionais que você deseja ativar para a configuração do agente.

      • Pulsação (Heartbeat): estado do Agente de Monitoramento Unificado. O valor 1 indica que o agente está disponível e 0 indica que o agente não está respondendo. Esta métrica está sempre ativada e não pode ser desativada.

        Dimensões: A versão, o sistema de operação, a arquitetura, a região, o AD e o ID da instância do Agente de Monitoramento Unificado da instância.

      • RestartMetric: Diferentemente da métrica Heartbeat, que é periódica, RestartMetric é enviado apenas uma vez durante o tempo de vida do agente, ou seja, quando o agente está sendo reiniciado. As reinicializações de monitoramento são essenciais para entender a estabilidade do agente. As reinicializações frequentes podem indicar falhas no sistema e estar ciente de reinicializações inesperadas pode ajudar os operadores a resolver problemas de configuração ou restrições de recursos.

        Dimensões: ID da Instância.

      • EmitRecords: O número total de registros de log emitidos. Um registro corresponde às linhas de log enviadas ao backend. Essa métrica fornece informações sobre o aumento e a diminuição do número de linhas de log ingeridas e o volume de logs que estão sendo processados. Uma queda ou aumento súbito nesse número pode sinalizar problemas no pipeline de log. Por exemplo, algumas linhas de log podem ser rejeitadas e não incluídas durante a ingestão de log.

        Dimensões: ID da Instância e tag.

      • BufferSpaceAvailable: O espaço de buffer disponível expresso como uma porcentagem. O valor começa em 100 e diminui à medida que o valor do buffer é usado. O agente usa buffers para lidar com bursts de dados de entrada e com backpressure potencial de saídas. O monitoramento dessa métrica ajuda a garantir que você não fique sem espaço no buffer, o que pode levar à perda de dados ou à repressão. Se o espaço no buffer estiver sendo executado de forma consistente, talvez você precise otimizar a configuração do agente e alocar mais recursos.

        Dimensões: ID da Instância e tag.

      • ShowFlushCount: O número total de liberações lentas. Descarregamento refere-se ao ato de enviar dados armazenados em buffer para seu destino pretendido. Uma descarga lenta significa que a descarga de dados do buffer para seu destino está demorando mais do que o limite definido. Esse número é incrementado quando a liberação do buffer tem mais de 20 segundos. O monitoramento de liberações lentas ajuda a identificar problemas de desempenho. Se os flushes forem consistentemente lentos, o buffer pode ser preenchido mais rapidamente do que os dados podem ser apagados, levando a problemas de perda de dados ou contrapressão.

        Dimensões: ID da Instância e tag.

      • RollbackCount: O número total de vezes que o agente faz rollback de uma transação porque não foi possível descarregar com sucesso o buffer para o destino de emissão. Normalmente, os rollbacks ocorrem quando uma gravação ou try_write falha ou problemas com o serviço OCI Logging, problemas de rede ou problemas de configuração estão presentes. As altas contagens de rollback são um indicador claro de problemas de confiabilidade no pipeline de log que precisam de investigação.

        Dimensões: ID da Instância e tag.

      • RetryCount: Rastreia o número de vezes que o agente tenta repetir uma operação de envio de dados após uma falha. As novas tentativas indicam problemas transitórios com a entrega de dados, e altas contagens de tentativas podem indicar instabilidade da rede. Embora os rollbacks possam lidar com problemas transacionais maiores, as novas tentativas muitas vezes indicam interrupções menores, possivelmente mais frequentes.

        Dimensões: ID da Instância e tag.

      Depois que a configuração do agente for criada, você poderá exibir quais métricas operacionais serão ativadas ao obter os detalhes da configuração de um agente.

  12. (Opcional) Clique em Mostrar opções adicionais. Em Adicionar Tags, adicione tags conforme necessário.
  13. (Opcional) Clique em Salvar como pilha para salvar a configuração do recurso como pilha.
      Para obter mais informações, consulte Criando uma Pilha com Base em uma Página de Criação de Recurso
  14. Clique em Criar.

  A configuração do agente é criada e aparece na página Configurações do Agente.

• Use o comando oci logging agent-configuration create e os parâmetros necessários para criar uma configuração do agente para log:

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

  For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

• Execute a operação CreateUnifiedAgentConfiguration para criar uma configuração de agente para log.