Access logs - Global Accelerator: Central de Documentação do Alibaba Cloud

Visão geral

Ative o registro de logs de acesso para um ou mais grupos de endpoints de uma instância do Global Accelerator (GA). Os logs coletados são entregues em um Logstore do Simple Log Service (SLS) na mesma região do grupo de endpoints. Cada entrada de log inclui campos como endereço IP de origem do cliente, porta de origem do cliente, endereço IP de destino, porta de destino e região de aceleração. Para obter detalhes sobre todos os campos, consulte Log fields.

Casos de uso

Solução de problemas

Use os logs de acesso para identificar e resolver problemas rapidamente.

Por exemplo, consulte o campo status para verificar o status dos pacotes de resposta do GA e investigar por que as solicitações não receberam a resposta esperada.
Planejamento de negócios

Os dados dos logs de acesso auxiliam no planejamento de recursos de negócios.

Por exemplo, analise as tendências de tráfego nas regiões de aceleração para planejar upgrades de largura de banda visando ao crescimento dos negócios ou downgrades para reduzir custos. Use também o campo http_host para visualizar os hosts que acessaram sua aplicação durante um período específico, facilitando a preparação para atualizações da aplicação.

Faturamento

O recurso de log de acesso do Global Accelerator (GA) é gratuito. Você paga apenas pelo uso do Simple Log Service (SLS). Para mais informações, consulte Billing of Simple Log Service.

Limitações

O recurso de log de acesso está disponível apenas nas regiões onde o Simple Log Service (SLS) também está disponível. Para mais informações, consulte Supported regions.
Somente instâncias padrão do GA suportam o recurso de log de acesso. Instâncias básicas do GA não oferecem esse suporte. Todas as operações descritas neste tópico aplicam-se a instâncias padrão do GA.
Logs de acesso não estão disponíveis para grupos de endpoints implantados em um ponto de presença (PoP) da Alibaba Cloud.
Não é possível consultar os nomes de domínio dos endpoints nos logs de acesso.
Caso não consiga usar o recurso de log de acesso, a versão da sua instância pode não ser compatível. Para usar esse recurso, entre em contato com seu gerente de contas para fazer o upgrade da instância.

Criar um log de acesso

Antes de criar um log de acesso, certifique-se de ter adicionado listeners e grupos de endpoints à sua instância do GA. Para mais informações, consulte Add and manage an intelligent routing type listener.

Faça login no console do Global Accelerator.
Na página Instances, clique em ID da instância do GA desejada.
Na página de detalhes da instância, clique em aba Access Log.

Na aba Access Log, clique em Create Access Log. Na caixa de diálogo Storage Configuration, configure os parâmetros a seguir e clique em OK.

Parâmetro		Descrição
Select Source	Listener ID/Name	Selecione um listener existente.
Select Source	Endpoint Group ID/Name	Selecione o grupo de endpoints desejado.
Storage Settings	Region	O padrão é a região onde o grupo de endpoints está localizado.
	Project	Um Project é uma unidade de gerenciamento de recursos no Simple Log Service (SLS) usada para isolamento e controle de recursos. Você pode Select Project ou Create Project.
	Logstore	Um Logstore é uma unidade no Simple Log Service (SLS) destinada à coleta, armazenamento e consulta de dados de log. Você pode Select Logstore ou Create Logstore.
Custom Headers	Enable Custom Headers	Quando ativado, o GA registra os cabeçalhos HTTP especificados no campo `ga_headers` do log de acesso. Nota O recurso de cabeçalhos personalizados para logs de acesso está em implementação gradual. Para usá-lo, entre em contato com seu gerente de contas para ativá-lo. Por padrão, o tamanho máximo dos cabeçalhos personalizados é de 1 KB. Entre em contato com seu gerente de contas para aumentar o limite para 4 KB. Ativar este recurso pode aumentar o volume de dados de log e gerar taxas adicionais do SLS. Para mais informações, consulte Billing of Simple Log Service.
Custom Headers	header name	Insira o nome do cabeçalho personalizado a ser registrado. Para especificar vários nomes de cabeçalho, separe-os por ponto e vírgula (;). Se deixar este campo em branco, todos os cabeçalhos serão registrados.

Nota

Ao ativar o registro de logs de acesso, o sistema verifica se a função vinculada ao service AliyunServiceRoleForGaFlowlog existe.

Se a função não existir, o sistema a criará automaticamente e anexará a política de permissões AliyunServiceRolePolicyForGaFlowlog. Isso concede ao GA as permissões necessárias para acessar o SLS e entregar logs no service.
Caso a função já exista, o sistema não a criará novamente.

Para mais informações, consulte AliyunServiceRoleForGaFlowlog.

Após criar o log de acesso, ele aparecerá na aba Access Log com o status Bound. Na coluna Actions, clique em View Log para visualizar os detalhes ou em Delete para remover a configuração do log de acesso.

Mais ações

Ações	Descrição
Visualizar um log de acesso	Na aba Access Log, localize o log de acesso desejado e clique em View Log na coluna Actions para abrir o console do SLS. Visualize e analise o log de acesso. Para mais informações, consulte Usage examples.
Edit Custom Header	Na aba Access Log, localize o log de acesso desejado e clique em Edit Custom Header na coluna Actions. Modifique a configuração e clique em OK.
Excluir um log de acesso	Na aba Access Log, localize o log de acesso desejado e clique em Delete na coluna Actions. Na caixa de diálogo Delete Log, clique em OK.

Depois que o SLS coletar os logs de acesso, baixe, entregue e processe os logs ou crie alertas. Para mais informações, consulte Common operations on logs of Alibaba Cloud services.

Exemplos de uso

Visualizar logs de acesso brutos

A aba Original Log no Logstore exibe os detalhes do log. Por exemplo, clique em campo client_ip para ver informações de solicitações de acesso provenientes de um endereço IP de origem específico.

Consultar logs de acesso específicos

Insira uma instrução SQL na caixa de pesquisa e análise na página do Logstore para consultar logs de acesso específicos.

Etapa	Descrição
1	Insira a seguinte instrução SQL para identificar as 10 principais regiões por distribuição de endereços IP de clientes. Essa informação auxilia no planejamento de negócios. `* \| select ip_to_geo(client_ip) as address, count(1) as count group by address order by count desc limit 10`
2	Selecione o intervalo de tempo dos logs de acesso que deseja visualizar e clique em Search & Analyze.
3	Na aba Graph > Properties, clique em ícone para visualizar a distribuição geográfica dos endereços IP dos clientes.

Campos de log

A tabela a seguir descreve os campos de log de acesso disponíveis no SLS.

Campo	Descrição
accelerator_region	A região de aceleração.
client_ip	O endereço IP de origem do cliente.
client_port	A porta de origem do cliente.
egress_bytes	O volume de tráfego de saída, em bytes, durante o período de amostragem.
endpoint_group_id	O ID do grupo de endpoints.
endpoint_group_region	A região onde o grupo de endpoints está implantado.
endpoint_ip	O endereço IP do endpoint, que corresponde ao endereço IP de destino.
endpoint_port	A porta do endpoint, que corresponde à porta de destino.
ga_id	O ID da instância do GA.
ingress_bytes	O volume de tráfego de entrada, em bytes, durante o período de amostragem.
listener_id	O ID do listener.
protocol	O protocolo de transporte de rede utilizado pelo listener.
status	O status do pacote de resposta do GA.
time	O momento em que o log foi registrado.
upstream_connect_time	A duração da conexão.
upstream_first_byte_time	O tempo até o primeiro byte.

Para listeners HTTP e HTTPS, os seguintes campos também são suportados.

Campo	Descrição
http_host	O conteúdo do cabeçalho `host` na solicitação.
http_referer	O conteúdo do cabeçalho `referer` na solicitação recebida pelo GA.
request_method	O método da solicitação.
request_uri	A URI da solicitação recebida pelo GA.
ga_headers	O conteúdo dos cabeçalhos personalizados. Após ativar o recurso de cabeçalhos personalizados, o GA registra os cabeçalhos HTTP especificados neste campo.