Configurazione dell'inclusione o dell'esclusione dei log

È possibile specificare se i registri sono inclusi o esclusi dalla raccolta in base a un percorso o a un nome di file configurato.

Compresi i percorsi

Per specificare i percorsi inclusi, completare i seguenti passaggi:

  1. Accedi al cluster. Per ulteriori informazioni, vedere Accesso al cluster.

  2. Nella mappa di configurazione Agent di registrazione, individuare la sezione input-kubernetes.conf. Quindi, aggiornare il parametro Path per specificare le fonti di log che si desidera raccogliere.

    Per impostazione predefinita, il Agent di registrazione raccoglie i log da una singola fonte situata all'indirizzo /var/log/containers/. Assicurarsi di aggiungere al parametro Path i percorsi di origine dei log desiderati per le proprie esigenze specifiche. Separare ogni percorso con una virgola.

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

    È possibile specificare fonti di log aggiuntive, separate da virgole, nel parametro Path.

    Per impostazione predefinita, l'applicazione IBM Cloud Logs Agent di registrazione raccoglie i log solo dalla directory /var/log/containers/*.log. Se si desidera raccogliere i log da tutte le sottodirectory sotto /var/log, è necessario aggiungere /var/log/**/*.log al parametro Path.

  3. Riavviare i pod dell'agente.

    Per i cluster Kubernetes, eseguire:

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

    Per i cluster OpenShift, eseguire:

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

Percorsi esclusi

Per specificare i percorsi da escludere, completare i seguenti passaggi:

  1. Accedi al cluster. Per ulteriori informazioni, vedere Accesso al cluster.

  2. Nella mappa di configurazione Agent di registrazione, individuare la sezione input-kubernetes.conf. Quindi, aggiornare il parametro Exclude_Path per specificare le sorgenti di log che si desidera escludere dalla raccolta. Questo parametro consente di specificare i percorsi che devono essere ignorati dal Agent di registrazione.

    Il parametro Exclude_Path potrebbe non essere presente per impostazione predefinita, quindi potrebbe essere necessario aggiungerlo se non esiste. Questo parametro consente di specificare i percorsi che devono essere ignorati dal Agent di registrazione.

    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

    È possibile specificare fonti di log aggiuntive, separate da virgole, nel parametro Exclude_Path.

  3. Riavviare i pod dell'agente.

    Per i cluster Kubernetes, eseguire:

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

    Per i cluster OpenShift, eseguire:

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

Esempio

Si consideri il seguente esempio con Exclude_Path specificato:

Ad esempio, se la struttura della directory è:

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

È possibile modificare la sezione input-kubernetes.conf come segue:

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

In questo esempio:

  • Il parametro Path specifica due percorsi da includere:

    • /var/log/containers/logger-agent-ds-*.log
    • /path/to/your/logs/*.log

  • Il parametro Exclude_Path viene utilizzato per specificare due percorsi aggiuntivi da escludere:

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

Tutti i file all'interno della directory che corrispondono allo schema specificato nel parametro Path saranno raccolti dal Agent di registrazione, tranne quelli che corrispondono agli schemi specificati in Exclude_Path.