Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2025-12-18 GMT+08:00

Restrições do ICAgent

Esta seção descreve as restrições no coletor de logs, ICAgent.

Tabela 1 Restrições de coleta de arquivos do ICAgent

Item

Descrição

Observações

Codificação de arquivo

Apenas UTF 8 é suportado. Outros formatos de codificação podem causar caracteres ilegíveis.

Por exemplo, arquivos binários.

N/A

Tamanho do arquivo de log

Sem restrições.

N/A

Rotação de arquivo de log

O ICAgent suporta a configuração de nomes de arquivos de log fixos ou correspondência difusa de nomes de arquivos de log. Você precisa rotacionar os arquivos de log manualmente.

N/A

Caminho de coleta de log

Linux

  • Os caminhos de coleta suportam recursão. Você pode usar asteriscos duplos (**) para coletar logs de até cinco níveis de diretório. Exemplo: /var/logs/**/a.log
  • Os caminhos de coleta suportam correspondência difusa. Você pode usar um asterisco (*) para representar um ou mais caracteres de um diretório ou nome de arquivo. Exemplo: /var/logs/*/a.log ou /var/logs/service/a*.log
  • Se o caminho de coleta for definido como um diretório, por exemplo, /var/logs/, apenas os arquivos .log, .trace e .out no diretório serão coletados. Se o caminho de coleta for definido como o nome de um arquivo de texto, esse arquivo será coletado diretamente.
  • Cada caminho de coleta deve ser exclusivo. Ou seja, o mesmo caminho do mesmo host não pode ser configurado para diferentes grupos de logs e fluxos de logs.

Windows

  • Os caminhos de coleta suportam recursão. Você pode usar asteriscos duplos (**) para coletar logs de até cinco níveis de diretório. Exemplo: C:\var\service\**\a.log
  • Os caminhos de coleta suportam correspondência difusa. Você pode usar um asterisco (*) para representar um ou mais caracteres de um diretório ou nome de arquivo. Exemplos: C:\var\service\*\a.log e C:\var\service\a*.log
  • Cada caminho de coleta deve ser exclusivo. Ou seja, o mesmo caminho do mesmo host não pode ser configurado para diferentes grupos de logs e fluxos de logs.
  • Cada caminho de coleta deve ser exclusivo. Ou seja, o mesmo caminho do mesmo host não pode ser configurado para diferentes grupos de logs e fluxos de logs.

N/A

Link simbólico

Links simbólicos não são suportados.

N/A

Tamanho de log único

O tamanho máximo de cada log é de 500 KB. O conteúdo em excesso será truncado pelo ICAgent.

N/A

Expressão regular

As expressões regulares Perl são suportadas.

N/A

Configuração de coleta de arquivos

Um arquivo pode ser relatado para apenas um grupo de logs e fluxo. Se um arquivo for configurado para vários fluxos de logs, apenas uma configuração terá efeito.

N/A

Abertura de arquivos

Os arquivos são abertos quando estão sendo lidos e fechados após serem lidos.

N/A

Primeira coleta de logs

Todos os logs são coletados.

N/A

Tabela 2 Especificações de desempenho do ICAgent

Item

Descrição

Observações

Taxa de coleta de logs

Logs brutos de um único nó são coletados a uma taxa de até 50 MB/s.

A qualidade do serviço não pode ser garantida se esse limite for excedido.

Diretórios monitorados

Até cinco níveis de diretórios são suportados, com até 1.000 arquivos.

N/A

Arquivos monitorados

Cenários de container

  • O ICAgent pode coletar um máximo de 20 arquivos de log de um diretório de montagem de volume.
  • O ICAgent pode coletar um máximo de 1.000 arquivos de log de saída de container padrão. Esses arquivos devem estar no formato JSON.

Cenários de VM: um máximo de 1.000 arquivos são suportados.

N/A

Restrições de recursos padrão

CPU:

  • Se a versão do ICAgent for anterior à 5.12.200, até dois núcleos de CPU serão consumidos.
  • Se a versão do ICAgent for 5.12.200 ou posterior, até dois núcleos de CPU serão consumidos quando não houver mais de 4 núcleos de nó, e os recursos máximos de CPU consumidos são log2(número de núcleos de nó) quando houver mais de 4 núcleos de nó.

Memória:

A memória máxima consumida é min{4 GB, Physical memory/2}. Um reinício é acionado se esse limite de memória for excedido. "min{4 GB, Physical memory/2}" significa que o menor valor entre metade da memória física e 4 GB é usado.

N/A

Limite de recursos atingido

Um reinício forçado é acionado. Os logs podem ser perdidos ou duplicados se forem rotacionados durante o reinício.

N/A

Instalação, atualização ou desinstalação do agente

Sem restrições.

N/A

Tabela 3 Outras restrições no ICAgent

Item

Descrição

Observações

Atualização de configuração

As atualizações de configuração entram em vigor em 1 a 3 minutos.

N/A

Carregamento dinâmico de configuração

As configurações do console podem ser entregues dinamicamente. A atualização de uma configuração não afeta outras configurações.

N/A

Configurações

Sem restrições.

N/A

Isolamento de locatário

Os locatários são isolados uns dos outros por padrão.

N/A

Atraso na coleta de logs

Normalmente, o atraso entre a gravação de logs no disco e a coleta de logs é inferior a 2 segundos (sem considerar o congestionamento).

N/A

Upload de logs

As alterações de arquivos são lidas e carregadas imediatamente após serem detectadas. Um ou mais logs podem ser carregados por vez.

N/A

Tratamento de erros de rede

Exceções de rede acionam tentativas novamente em um intervalo de 5 segundos.

N/A

Cota de recursos esgotada

Se os recursos alocados ao ICAgent forem insuficientes devido a grandes quantidades de logs, o ICAgent continuará e tentará novamente em caso de falha. Os logs serão empilhados se os recursos ainda forem insuficientes.

N/A

Tempo limite máximo de nova tentativa

As tentativas de nova tentativa são feitas periodicamente.

N/A

Verificação de status

O status do coletor é monitorado por meio da detecção de heartbeat.

N/A

Tempo limite de ponto de verificação

Os pontos de verificação são excluídos automaticamente se nenhuma atualização for feita dentro de 12 horas.

N/A

Salvar ponto de verificação

Os pontos de verificação são atualizados se os logs forem relatados com sucesso.

N/A

Caminho de salvamento de ponto de verificação

Por padrão, os pontos de verificação são salvos em /var/share/oss/manager/ICProbeAgent/internal/TRACE.

N/A

Logs perdidos ou repetidos

O ICAgent usa vários mecanismos para garantir a confiabilidade da coleta de logs e evitar a perda de dados. No entanto, os logs podem ser perdidos ou repetidos nos seguintes cenários:

  • A política de rotação de logs do CCE não é usada.
  • Os arquivos de log são rotacionados em alta velocidade, por exemplo, uma vez por segundo.
  • Os logs não podem ser encaminhados devido a configurações de segurança do sistema inadequadas ou ao próprio syslog.
  • O tempo de execução do container, por exemplo, menor que 30 s, é extremamente curto.
  • Um único nó gera logs em alta velocidade, excedendo a largura de banda de transmissão ou a velocidade de coleta de logs permitida. Recomenda-se que a velocidade de geração de logs de um único nó seja inferior a 50 MB/s.

Quando o ICAgent é reiniciado, dados idênticos podem ser coletados em torno do horário da reinicialização.

N/A

Tabela 4 Endereços IP acessíveis ao ICAgent

Componente/serviço

Endereço IP

Descrição

OpenStack

http://169.254.169.254/openstack/latest/meta_data.json

Obtenha os metadados, o nome e o ID de um nó.

http://169.254.169.254/openstack/latest/securitykey

Obtenha uma AK/SK temporária e um token de segurança com uma agência.

http://169.254.169.254/latest/meta-data/public-ipv4

Obtenha o EIP vinculado a um nó.

CCE

http://127.0.0.1:4194/api/v2.0/ps

Obtenha informações de processo com a API cAdvisor.

http://127.0.0.1:4194/api/v1.2/docker

Obtenha todas as métricas de container com a API cAdvisor.

http://nodeip:10255/pods

Obtenha informações de pod com uma API do Kubernetes.

Tabela 5 Portas acessíveis ao ICAgent

Número da porta

Descrição

#icmgr-service 
{podlb}:30200

Registro do ICAgent

icmgr-controller
{podlb}:30201

Configuração de status do ICAgent

#als-access 
{podlb}:8102

Relatórios de log

#ams-access 
{podlb}:8149

Relatórios de métricas

#ats-access apm
{podlb}:8923

Relatórios de dados para o APM