Configurar se os registros são incluídos ou excluídos

Você pode especificar se os logs serão incluídos ou excluídos da coleta com base em um caminho configurado ou nome de arquivo.

Incluindo caminhos

Para especificar os caminhos incluídos, conclua as etapas a seguir:

  1. Efetue login no cluster. Para obter mais informações, consulte Acessar seu cluster.

  2. No mapa de configuração Agente de criação de log, localize a seção input-kubernetes.conf. Em seguida, atualize o parâmetro Path para especificar as fontes de registro que deseja coletar.

    Por padrão, o Agente de criação de log coleta logs de uma única fonte localizada em /var/log/containers/. Certifique-se de adicionar os caminhos de origem de log desejados ao parâmetro Path para seus requisitos específicos. Separe cada caminho com uma vírgula.

    input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/*.log,/path/to/your/logs/*.log
        Path_Key          file
    

    Fontes de registro adicionais podem ser especificadas e separadas por vírgulas no parâmetro Path.

    Por padrão, o IBM Cloud Logs Agente de criação de log coleta logs somente do diretório /var/log/containers/*.log. Se quiser coletar logs de todos os subdiretórios em /var/log, será necessário adicionar /var/log/**/*.log ao parâmetro Path.

  3. Reinicie os pods de agente.

    Para clusters Kubernetes, execute:

    kubectl -n ibm-observe rollout restart ds/logs-agent
    

    Para clusters OpenShift, execute:

    oc -n ibm-observe rollout restart ds/logs-agent
    

Exclusão de caminhos

Para especificar os caminhos a serem excluídos, conclua as etapas a seguir:

  1. Efetue login no cluster. Para obter mais informações, consulte Acessar seu cluster.

  2. No mapa de configuração Agente de criação de log, localize a seção input-kubernetes.conf. Em seguida, atualize o parâmetro Exclude_Path para especificar as origens de log que você deseja excluir da coleta. Esse parâmetro permite que você especifique caminhos que devem ser ignorados pelo Agente de criação de log.

    O parâmetro Exclude_Path pode não estar presente por padrão, portanto, talvez seja necessário adicioná-lo se ele não existir. Esse parâmetro permite que você especifique os caminhos que devem ser ignorados pelo Agente de criação de log.

    input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
        Path_Key          file
        Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log
    

    Fontes de registro adicionais podem ser especificadas e separadas por vírgulas no parâmetro Exclude_Path.

  3. Reinicie os pods de agente.

    Para clusters Kubernetes, execute:

    kubectl -n ibm-observe rollout restart ds/logs-agent
    

    Para clusters OpenShift, execute:

    oc -n ibm-observe rollout restart ds/logs-agent
    

Amostra

Considere o exemplo a seguir com Exclude_Path especificado:

Por exemplo, se sua estrutura de diretório for:

/path/to/your/logs
                ├── app1.log
                ├── app2.log
                ├── exclude-1.log
                └── exclude-2.log

Você pode modificar a seção input-kubernetes.conf da seguinte forma:

input-kubernetes.conf: |
    [INPUT]
        Name              tail
        Tag               kube.*
        Path              /var/log/containers/logger-agent-ds-*.log,/path/to/your/logs/*.log
        Path_Key          file
        Exclude_Path      /path/to/your/logs/exclude-1.log,/path/to/your/logs/exclude-2.log

Nesse exemplo:

  • O parâmetro Path especifica dois caminhos a serem incluídos:

    • /var/log/containers/logger-agent-ds-*.log
    • /path/to/your/logs/*.log
  • O parâmetro Exclude_Path é usado para especificar dois caminhos adicionais a serem excluídos:

    • /path/to/your/logs/exclude-1.log
    • /path/to/your/logs/exclude-2.log

Todos os arquivos no diretório que corresponderem ao padrão especificado no parâmetro Path serão coletados pelo Agente de criação de log, exceto aqueles que corresponderem aos padrões especificados em Exclude_Path.