Configurando os agentes de host d Instana

Para Instana, SaaS, e TLS, os certificados para conexões do backend do agente são fornecidos por Instana. Para back-ends do Instana hospedados localmente, os certificados do TLS para conexões com o back-end podem ser fornecidos pelo cliente. Para obter mais informações, consulte Como usar certificados existentes para a edição padrão auto-hospedada.

Para back-ends do Instana hospedados localmente, é possível configurar os agentes do Instana para verificar a impressão digital do certificado do back-end TLS. No arquivo *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend.cfg , forneça à fingerprints propriedade uma lista de impressões digitais de certificados separadas por vírgulas. O agente recusa conexões com qualquer backend que não corresponda às impressões digitais especificadas.

Exemplo de configuração:

fingerprints=29:17:5A:F4:2E:35:DF:87:D6:1F:4D:C8:A8:01:D2:43:18:47:BF:6E
 

Em alguns casos, você pode precisar de um agente para relatar para diversos backends. Por exemplo, se os serviços compartilhados forem usados por ambientes separados, será possível configurar manualmente um agente para relatar para diversos backends nesses ambientes separados

O agente é contado em todos os back-ends separadamente porque o número de licenças que ele usa e a configuração efetivamente multiplica o consumo de largura da banda do agente

Para configurar o agente do host para relatar para vários backends. siga as etapas:

1. Renomeie o arquivo de configuração *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend.cfg para *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend-1.cfg
2. Crie cópias do arquivo de configuração *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend-2.cfg com as configurações apropriadas para vários backends que o agente relata.

Cada um dos arquivos criados na etapa anterior pode ser ajustado para descrever um ponto de extremidade do agente do host e chaves de agente diferentes. Esses arquivos podem até mesmo conter diferentes configurações de proxy.

Notas:

• É possível usar qualquer ID numérico ou alfanumérico no arquivo de configuração.. Por exemplo,*instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend-<alphanumeric>.cfg

• Se o arquivo de configuração *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.Backend.cfg existir, todos os outros arquivos de backend serão ignorados.

• As imagens do agente de host do Instana Docker são especialmente configuradas, de modo que a adição de back-ends adicionais pode ser feita facilmente montando os arquivos do back-end, tais como com.instana.agent.main.sender.Backend-2.cfg.

  Um argumento de exemplo para um agente dockerizado é o seguinte:

  --volume <path-to-additional-backend-config>:/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend-2.cfg

Para manter em sigilo os dados confidenciais de autenticação do proxy, você pode vincular as configurações do proxy usando variáveis de ambiente.

Você pode usar o exemplo a seguir no <instana-agent-dir>/etc/instana/com.instana.agent.main.sender.Backend.cfg arquivo para configurar as propriedades do proxy de back-end por meio de variáveis de ambiente. Você deve definir o nome de usuário e a senha nas variáveis de ambiente BACKEND_PROXY_USER e BACKEND_PROXY_PASSWORD.

proxy.user=${env:BACKEND_PROXY_USER}
proxy.password=${env:BACKEND_PROXY_PASSWORD}

Você pode usar o exemplo a seguir para o mvn-settings.xml arquivo de configuração do proxy do repositório Maven, utilizando variáveis de ambiente. Você deve definir o nome de usuário e a senha nas variáveis de ambiente MAVEN_PROXY_USER e MAVEN_PROXY_PASSWORD.

<proxies>
  <proxy>
    <id>agent-proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <username>${env.MAVEN_PROXY_USER}</username>
    <password>${env.MAVEN_PROXY_PASSWORD}</password>
    <host></host>
    <port></port>
  </proxy>
</proxies>

Você pode configurar um proxy Squid ( www.squid-cache.org ) em conjunto com Instana, quando não houver outros proxies disponíveis.

Várias maneiras estão disponíveis para instalar o Squid em seu sistema A maioria das distribuições do Linux® inclui o Squid em seus repositórios e o software pode ser instalado usando o gerenciador de pacotes preferencial

Se nenhum pacote estiver disponível ou você desejar executar o Squid no Microsoft® Windows®, será possível obter arquivos binários do Squid a partir da (Squid documentação do cache da web)

Após a instalação do Squid , uma configuração de exemplo squid.conf é criada e ela tem uma configuração padrão Se você deseja usar o proxy exclusivamente para a comunicação com o Instana, pode fazer um backup da configuração padrão e usar a seguinte configuração do squid.conf :

# The tcp port squid is listening on
http_port 3128

# Please specify subnet with instana agents
acl instana_agent_net src 10.0.0.0/8

# This is the ip of the instana backend
acl instana_backend dstdomain saas-eu-west-1.instana.io
#acl instana_backend dstdomain ec2-54-144-114-141.compute-1.amazonaws.com
#acl instana_backend dstdomain saas-us-east-1.instana.io
#acl instana_backend dstdomain saas-us-east-1.instana.io

# This is the port used by Instana
acl instana_backend_port port 443

# This is the repo to download updates and additional sensors
acl instana_repo dstdomain artifact-public.instana.io
acl instana_repo_port port 80
acl instana_repo_port_secure port 443

# Protocol used for instana backend
acl instana_backend_proto proto HTTP

# Protocol used for instana backend
acl instana_repo_proto proto HTTP
acl instana_repo_proto_secure proto HTTPS

http_access allow instana_agent_net instana_backend instana_backend_port
http_access allow instana_agent_net instana_repo instana_repo_port
http_access allow instana_agent_net instana_repo instana_repo_port_secure

# DO NOT REMOVE THIS RULE!
http_access deny all

Você pode encontrar os seguintes problemas de monitoramento ao configurar a criptografi TLS e para um endpoint de agente. Essas questões são exibidas no painel do agente na interface do usuário do Instana. É necessário resolvê-los antes de continuar..

Tipo de problema de monitoramento: agent_tls_cert_expired

O certificado utilizado para configurar a criptografia do TLS no terminal do agente expira. Certifique-se de substituir o certificado expirado por um novo arquivo de certificado.

Tipo de problema de monitoramento: agent_tls_cert_about_to_expire

O certificado utilizado para configurar a criptografia do TLS para o terminal do agente está prestes a expirar dentro de alguns dias. Certifique-se de substituir o certificado por um novo arquivo de certificado.

Os agentes de host dinâmicos podem se atualizar e, assim, reduzir a sobrecarga de gerenciamento. Para configurar as atualizações dos agentes de host dinâmicos, como definir o intervalo de atualização, consulte Configurando as atualizações dos agentes de host dinâmicos.

Como o modo de agente também pode ser configurado a partir da interface do usuário do Instana, o arquivo de configuração possui um sinalizador que pode ser usado para desativar essa substituição. Dessa forma, o modo do agente pode ser configurado usando apenas o arquivo de configuração ou uma variável de ambiente local para o agente instalado.

Se você não desejar configurar o modo do agente a partir da UI, inclua a linha a seguir no arquivo de configuração *instanaAgentDir*/etc/instana/com.instana.agent.main.config.Agent.cfg :

mode.web-override.allowed = false

Por padrão, o agente usa uma rotação de log de 10 vezes 5 MB de arquivos de log do agente. Ou seja, a cada 5 MB, o arquivo é girado e 10 arquivos são mantidos e o arquivo 11 é excluído.

log4j2.appender.rolling.policy.type = SizeBasedTriggeringPolicy
log4j2.appender.rolling.policy.size = 5MB
log4j2.appender.rolling.strategy.type = DefaultRolloverStrategy
log4j2.appender.rolling.strategy.max = 10

O agente usa Log4j2, que é um recurso de criação de log moderno e flexível. Veja o exemplo a seguir para configurar syslog:

log4j2.rootLogger.appenderRef.Syslog.ref = Syslog
log4j2.rootLogger.appenderRef.Syslog.level = ERROR
log4j2.appender.syslog.type=Syslog
log4j2.appender.syslog.name=Syslog
log4j2.appender.syslog.layout.type=PatternLayout
log4j2.appender.syslog.layout.pattern = ${log4j2.pattern}
log4j2.appender.syslog.facility=SYSLOG
log4j2.appender.syslog.host=localhost
log4j2.appender.syslog.port=514
log4j2.appender.syslog.protocol=UDP

Em imagens de contêiner customizadas, talvez você queira registrar no STDOUT. É possível fazer isso fornecendo a seguinte configuração no arquivo de configuração <instana-agent-install-dir>etc/org.ops4j.pax.logging.cfg :

log4j2.rootLogger.appenderRef.Console.ref = Console

log4j2.appender.console.type = Console
log4j2.appender.console.name = Console
log4j2.appender.console.layout.type = PatternLayout
log4j2.appender.console.layout.pattern = ${log4j2.pattern}

Como a criação de log usa a criação de log log4j2 padrão, ela pode ser configurada de muitas outras maneiras, conforme descrito na log4j2 documentação.

O agente pode registrar temporariamente métricas ou rastreios que são enviados por meio desse agente para um arquivo no disco. O recurso para registrar métricas ou rastreios em um arquivo geralmente é usado para depurar vários problemas relacionados a métricas, rastreios, rastreio ou extensões.

Para ativar o recurso, localize o arquivo de configuração *instanaAgentDir*/etc/instana/com.instana.agent.main.sender.File.cfg e atualize seu conteúdo com os comandos a seguir:

# Configuration of local logging. Changes will be hot-reloaded.
# Activate logging of outgoing payloads to local disk by setting a non-empty
# prefix. The log file will be written to data/log, and the file will have the
# defined prefix followed by a timestamp.
# Note: There is no automatic rotation of those files.
prefix=locallog

# The file can be filtered to either "metrics" or "traces".
# If empty or absent, there will be no filtering.
type=traces

Conforme observado, as mudanças são recarregadas a quente e podem ser ativadas imediatamente O recurso deve ser ativado temporariamente apenas porque deixar o recurso ativado tem o potencial de ocupar todo o espaço em disco disponível, se for fornecido tempo e tráfego suficientes para ele.

Permita que a criação de log continue por um ou dois minutos enquanto o tráfego é gerado para o componente ao rastrear os problemas. Em seguida, reverta as alterações ou comente todas as linhas nesse arquivo. Mais uma vez, as alterações gravadas no disco são recarregadas dinamicamente pelo agente do ` Instana `.

Se você estiver trabalhando com um ticket de suporte, anexe o arquivo de log resultante no ticket de suporte. O arquivo de log está localizado no arquivo de log *instanaAgentDir*/data/log/locallog_*.log ..

1. Crie um arquivo de configuração denominado /etc/systemd/system/instana-agent.service.d/20-resource_limits.confe inclua o seguinte conteúdo nele:

   [Service]
   # ------------------------------------------------------------
   # CPU accounting and request-style configuration
   # ------------------------------------------------------------
   
   # Enable per-unit CPU usage accounting so that systemd and tools like
   # systemd-cgtop can report precise CPU usage for this service.
   CPUAccounting=true
   
   # cgroup v2:
   # CPUWeight defines relative CPU share (range 1-10000, default about 100).
   # 50 is about half of the default share and behaves similar to "0.5 CPU requested".
   # This is a soft, work-conserving control: the service can still use full CPU
   # when the system is idle but will get less CPU when there is contention.
   CPUWeight=50
   
   # cgroup v1:
   # CPUShares defines relative CPU share (default 1024).
   # 512 is half of the default share and behaves similar to "0.5 CPU requested".
   # Same semantics as CPUWeight above: acts only under contention, not as a hard cap.
   CPUShares=512
   
   # CPUQuota enforces a strict CPU ceiling and causes throttling even when the
   # machine is idle. This is not encouraged for the agent.
   #
   # In practice, using CPUQuota for the agent has been observed to:
   # - Degrade performance when the agent needs more CPU than the quota allows.
   # - Increase total CPU consumption compared to not throttling at all,
   #   because the agent needs more time to complete the same work while
   #   constantly being throttled.
   #
   #CPUQuota=50%
   
   
   # ------------------------------------------------------------
   # Memory accounting and hard memory limit
   # ------------------------------------------------------------
   
   # Enable per-unit memory usage accounting so that systemd and tools like
   # systemd-cgtop can report memory usage for this service.
   MemoryAccounting=true
   
   # MemoryMax sets a hard upper bound on memory usage for this service
   # and its child processes. When the limit is reached, the kernel will
   # reclaim memory or kill processes to enforce the limit.
   #
   # A hard memory limit is recommended for the agent to prevent runaway
   # memory usage from impacting the host.
   MemoryMax=768M

2. Execute o systemctl daemon-reload.

3. Reinicie o serviço do instana-agent

Execute o contêiner instana-agent com os parâmetros adicionais a seguir:

Para Docker 1.13 e mais recente:

--cpus=0.5 --memory=512m

Para Docker 1.12 e anterior:

--cpu-period=100000 --cpu-quota=50000 --memory=512m

Inclua o fragmento de configuração a seguir na configuração de contêiner do agente do host:

livenessProbe:
  httpGet: # Agent liveness is published on localhost:42699/status
    path: /status
    port: 42699
  initialDelaySeconds: 75
  periodSeconds: 5
resources:
  requests:
    memory: "768Mi"
    cpu: "0.5"
  limits:
    # Memory requests and limits should be equal to ensure the pod gets
    # a guaranteed QoS class for memory, preventing memory-based eviction.
    memory: "768Mi"
    # CPU limits are not recommended for the agent as they can cause throttling
    # and degrade performance. Use requests to define relative CPU priority.
    # If you must set a CPU limit, use a value significantly higher than requests:
    #cpu: "1.5"

A configuração define a CPU e a memória para o instana-agent contêiner e estabelece um limite rígido de memória para evitar o uso excessivo de memória. As solicitações e os limites de memória são definidos com o mesmo valor para garantir a alocação garantida ( QoS ) de memória. Os limites da CPU foram omitidos intencionalmente para evitar a limitação de recursos que pode reduzir o desempenho do agente.