Configurando o daemon AWS X-Ray

Você pode usar opções de linha de comando ou um arquivo de configuração para personalizar o comportamento do daemon do X-Ray. A maioria das opções está disponível usando os dois métodos, mas algumas estão disponíveis apenas em arquivos de configuração e outras apenas na linha de comando. Neste post, iremos apresentar como configurar o daemon do AWS X-Ray.

Para começar, a única opção que você precisa saber é -n ou — region, que você usa para definir a região que o daemon usa para enviar dados de rastreamento para o X-Ray.

~/xray-daemon$ ./xray -n us-east-2

Se você estiver executando o daemon localmente, ou seja, não no Amazon EC2, pode adicionar a -oopção de ignorar a verificação das credenciais do perfil da instância para que o daemon fique pronto mais rapidamente.

~/xray-daemon$ ./xray -o -n us-east-2

O restante das opções de linha de comando permitem configurar o registro, escutar em uma porta diferente, limitar a quantidade de memória que o daemon pode usar ou assumir uma função para enviar dados de rastreamento para uma conta diferente.

Você pode passar um arquivo de configuração para o daemon para acessar opções de configuração avançada e fazer coisas como limitar o número de chamadas simultâneas para o X-Ray, desabilitar a rotação de log e enviar tráfego para um proxy.

Variáveis ​​de ambiente com suporte

O daemon do X-Ray oferece suporte às seguintes variáveis ​​de ambiente:

• AWS_REGION — Especifica a região AWS do ponto de extremidade de serviço do X-Ray.
• HTTPS_PROXY — Especifica um endereço de proxy para o daemon para fazer upload de segmentos. Podem ser nomes de domínio DNS ou endereços IP e números de porta usados ​​por seus servidores proxy.

Usando opções de linha de comando

Passe essas opções para o daemon ao executá-lo localmente ou com um script de dados do usuário.

Opções de linha de comando

• -b, — bind- Ouça documentos de segmento em uma porta UDP diferente.
• — bind “127.0.0.1:3000”
• Padrão — 2000.
• -t, — bind-tcp- Ouça chamadas para o serviço X-Ray em uma porta TCP diferente.
• -bind-tcp “127.0.0.1:3000”
• Padrão — 2000.
• -c, — config- Carrega um arquivo de configuração do caminho especificado.
• — config “/home/ec2-user/xray-daemon.yaml”
• -f, — log-file- Registros de saída para o caminho de arquivo especificado.
• — log-file “/var/log/xray-daemon.log”
• -l, — log-level- Nível de log, do mais detalhado para o menos: dev, debug, info, warn, error, prod.
• — log-level warn
• Padrão — prod
• -m, — buffer-memory- Altere a quantidade de memória em MB que os buffers podem usar (mínimo 3).
• — buffer-memory 50
• Padrão — 1% da memória disponível.
• -o, — local-mode- Não verifique os metadados da instância EC2.
• -r, — role-arn- Assuma a função IAM especificada para fazer upload de segmentos para uma conta diferente.
• — role-arn “arn:aws:iam::123456789012:role/xray-cross-account”
• -a, — resource-arn- Amazon Resource Name (ARN) do recurso AWS executando o daemon.
• -p, — proxy-address- Carregar segmentos para AWS X-Ray por meio de um proxy. O protocolo do servidor proxy deve ser especificado.
• — proxy-address "http://192.0.2.0:3000"
• -n, — region- Envie segmentos para o serviço de Raios-X em uma região específica.
• -v, — version- Mostra a versão do daemon do AWS X-Ray.
• -h, — help- Mostra a tela de ajuda.

Usando um arquivo de configuração

Você também pode usar um arquivo de formato YAML para configurar o daemon. Passe o arquivo de configuração para o daemon usando a -copção.

~$ ./xray -c ~/xray-daemon.yaml

Opções de arquivo de configuração

• TotalBufferSizeMB- Tamanho máximo do buffer em MB (mínimo 3). Escolha 0 para usar 1% da memória do host.
• Concurrency — Número máximo de chamadas simultâneas para AWS X-Ray para fazer upload de documentos de segmento.
• Region — Envie segmentos para o serviço AWS X-Ray em uma região específica.
• Socket — Configure a ligação do daemon.
• Logging — Configure o comportamento de registro.
• LocalMode- Defina como truepara ignorar a verificação de metadados da instância EC2.
• ResourceARN — Amazon Resource Name (ARN) do recurso AWS que executa o daemon.
• RoleARN — Assuma a função IAM especificada para fazer upload de segmentos para uma conta diferente.
• ProxyAddress — Carregue segmentos para AWS X-Ray por meio de um proxy.
• Endpoint — Altere o ponto de extremidade de serviço do X-Ray para o qual o daemon envia documentos de segmento.
• NoVerifySSL — Desative a verificação do certificado TLS.
• Version- Versão do formato do arquivo de configuração do Daemon. A versão do formato do arquivo é um campo obrigatório .

Exemplo Xray-daemon.yaml

Este arquivo de configuração altera a porta de escuta do daemon para 3000, desativa as verificações de metadados da instância, define uma função a ser usada para fazer upload de segmentos e altera a região e as opções de registro.

Socket:
 UDPAddress: “127.0.0.1:3000”
 TCPAddress: “127.0.0.1:3000”
Region: “us-west-2”
Logging:
 LogLevel: “warn”
 LogPath: “/var/log/xray-daemon.log”
LocalMode: true
RoleARN: “arn:aws:iam::123456789012:role/xray-cross-account”
Version: 2

Até o próximo post! =)