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 Campos de log.

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.

Analise as tendências de tráfego nas regiões de aceleração para planejar upgrades de largura de banda visando o 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 em um período específico, facilitando a preparação para atualizações.

Faturamento

O recurso de log de acesso do Global Accelerator (GA) é gratuito. Paga-se apenas pelo uso do Simple Log Service (SLS). Para mais informações, consulte Faturamento do Simple Log Service.

Limitações

O recurso de log de acesso está disponível apenas em regiões onde o Simple Log Service (SLS) também está disponível. Para mais informações, consulte Regiões suportadas.
Somente instâncias GA padrão oferecem suporte ao recurso de log de acesso. Instâncias GA básicas não oferecem esse suporte. Todas as operações descritas neste tópico aplicam-se a instâncias GA padrão.
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.
Se não for possível usar o recurso de log de acesso, a versão da instância pode não oferecer suporte a ele. Para habilitar essa funcionalidade, entre em contato com seu gerente de contas e solicite 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 GA. Para mais informações, consulte Adicionar e gerenciar um listener do tipo roteamento inteligente.

Faça login no console do Global Accelerator.
Na página Instances, clique em ID da instância 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 abaixo 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	O 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 utilizá-lo, entre em contato com seu gerente de contas e solicite a ativação. Por padrão, o tamanho máximo dos cabeçalhos personalizados é de 1 KB. Entre em contato com seu gerente de contas para aumentar esse 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 Faturamento do 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 serviço 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 nesse serviço.
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 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 Exemplos de uso.
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 coleta os logs de acesso, você pode baixar, entregar e processar esses logs ou criar alertas. Para mais informações, consulte Operações comuns em logs de serviços da Alibaba Cloud.

Exemplos de uso

Visualizar logs de acesso brutos

A aba Original Log no Logstore exibe os detalhes dos logs.

Por exemplo, clique em campo client_ip para visualizar informações de solicitações de acesso de um endereço IP de origem específico. O log inclui os seguintes campos: accelerator_region, client_ip, client_port, egress_bytes, endpoint_group_id, endpoint_group_region, endpoint_ip, endpoint_port, ga_id, http_host, http_referer, ingress_bytes, listener_id, protocol, request_method, request_uri, status e time. Filtre os logs por campo usando uma instrução de consulta, como * and client_ip : "118.123.xxx", e visualize a distribuição de valores de cada campo no painel Quick Analytics à esquerda.

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.

Por exemplo, siga estas etapas para consultar a distribuição de endereços IP dos clientes. No painel Properties, selecione Map como tipo de gráfico, defina Latitude and Longitude como address e configure Value Column como count.

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 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.