As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Analise o acesso ao armazenamento de objetos com os registros de bucket do Lightsail
O registro de acesso fornece registros detalhados das solicitações feitas a um bucket no serviço de armazenamento de objetos Amazon Lightsail. Você pode usar logs de acesso para auditorias de segurança e acesso, ou para saber mais sobre sua base de clientes. Esta seção descreve o formato e outros detalhes sobre os arquivos de log de acesso. Para obter mais informações sobre noções básicas de registro em log, consulte Bucket access logs.
Os arquivos de log de acesso consistem em uma sequência de registros de log delimitados por novas linhas. Cada registro do log representa uma solicitação e consiste em campos delimitados por espaço.
Veja a seguir o exemplo de um log que consiste em cinco registros de log.
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DOC-EXAMPLE-BUCKET [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 3E57427F3EXAMPLE REST.GET.VERSIONING - "GET /DOC-EXAMPLE-BUCKET?versioning HTTP/1.1" 200 - 113 - 7 - "-" "S3Console/0.4" - s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234= SigV2 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader DOC-EXAMPLE-BUCKET.s3.us-west-1.amazonaws.com TLSV1.1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DOC-EXAMPLE-BUCKET [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 891CE47D2EXAMPLE REST.GET.LOGGING_STATUS - "GET /DOC-EXAMPLE-BUCKET?logging HTTP/1.1" 200 - 242 - 11 - "-" "S3Console/0.4" - 9vKBE6vMhrNiWHZmb2L0mXOcqPGzQOI5XLnCtZNPxev+Hf+7tpT6sxDwDty4LHBUOZJG96N1234= SigV2 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader DOC-EXAMPLE-BUCKET.s3.us-west-1.amazonaws.com TLSV1.1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DOC-EXAMPLE-BUCKET [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be A1206F460EXAMPLE REST.GET.BUCKETPOLICY - "GET /DOC-EXAMPLE-BUCKET?policy HTTP/1.1" 404 NoSuchBucketPolicy 297 - 38 - "-" "S3Console/0.4" - BNaBsXZQQDbssi6xMBdBU2sLt+Yf5kZDmeBUP35sFoKa3sLLeMC78iwEIWxs99CRUrbS4n11234= SigV2 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader DOC-EXAMPLE-BUCKET.s3.us-west-1.amazonaws.com TLSV1.1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DOC-EXAMPLE-BUCKET [06/Feb/2019:00:01:00 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 7B4A0FABBEXAMPLE REST.GET.VERSIONING - "GET /DOC-EXAMPLE-BUCKET?versioning HTTP/1.1" 200 - 113 - 33 - "-" "S3Console/0.4" - Ke1bUcazaN1jWuUlPJaxF64cQVpUEhoZKEG/hmy/gijN/I1DeWqDfFvnpybfEseEME/u7ME1234= SigV2 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader DOC-EXAMPLE-BUCKET.s3.us-west-1.amazonaws.com TLSV1.1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DOC-EXAMPLE-BUCKET [06/Feb/2019:00:01:57 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DD6CC733AEXAMPLE REST.PUT.OBJECT s3-dg.pdf "PUT /DOC-EXAMPLE-BUCKET/s3-dg.pdf HTTP/1.1" 200 - - 4406583 41754 28 "-" "S3Console/0.4" - 10S62Zv81kBW7BB6SX4XJ48o6kpcl6LPwEoizZQQxJd5qDSCTLX0TgS37kYUBKQW3+bPdrg1234= SigV4 ECDHE-RSA-AES128-SHA AuthHeader DOC-EXAMPLE-BUCKET.s3.us-west-1.amazonaws.com TLSV1.1
nota
Qualquer campo de registro de log pode ser definido como – (travessão) para indicar dados desconhecidos ou indisponíveis, ou ainda que o campo não era aplicável à solicitação.
Índice
Campos de registro de log
A lista a seguir descreve os campos dos registros em log.
ARN (nome do recurso da Amazon) do ponto de acesso
O nome de recurso da Amazon (ARN) do ponto de acesso da solicitação. Se o ARN do ponto de acesso estiver malformado ou sem uso, o campo apresentará um '-'. Para mais informações sobre pontos de acesso, consulte Using access points (Como usar pontos de acesso). Para mais informações sobre os ARNs, consulte o tópico sobre o Nome do recurso da Amazon (ARN) na Referência geral da AWS.
Exemplo de registro
arn:aws:s3:us-east-1:123456789012:accesspoint/example-AP
Proprietário do bucket
O ID canônico do usuário do proprietário do bucket de origem. O ID de usuário canônico é uma outra forma do ID da conta da AWS. Para mais informações sobre IDs canônicas de usuário, consulte AWS account identifiers (Identificadores de conta da AWS) na Referência geral da AWS. Para informações sobre como encontrar o ID canônico de usuário da conta, consulte Finding the canonical user ID for your AWS account (Como encontrar o ID de usuário canônico da conta da AWS).
Exemplo de registro
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
Bucket
O nome do bucket no qual a solicitação foi processada. Se o sistema receber uma solicitação malformada e não puder determinar o bucket, a solicitação não aparecerá em nenhum log de acesso.
Exemplo de registro
DOC-EXAMPLE-BUCKET
Tempo
O horário em que a solicitação foi recebida. As datas e horas estão em Tempo Universal Coordenado (UTC). O formato, utilizando a terminologia strftime(), é o seguinte: [%d/%b/%Y:%H:%M:%S %z]
Exemplo de registro
[06/Feb/2019:00:00:38 +0000]
IP remoto
O endereço de internet aparente do solicitante. Os proxies e os firewalls intermediários podem obscurecer o endereço real da máquina que faz a solicitação.
Exemplo de registro
192.0.2.3
Solicitante
O ID canônico do usuário do solicitante ou um - para solicitações não autenticadas. Se o solicitante for um usuário do IAM, esse campo retorna o nome do usuário do IAM do solicitante junto com a conta raiz da AWS à qual o usuário do IAM pertence. Esse identificador é o mesmo usado para fins de controle de acesso.
Exemplo de registro
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
ID da solicitação
Uma string gerada pelo Lightsail para identificar de forma exclusiva cada solicitação.
Exemplo de registro
3E57427F33A59F07
Operação
A operação listada aqui é declarada como SOAP., operationREST., HTTP_method.resource_typeWEBSITE. ou HTTP_method.resource_typeBATCH.DELETE.OBJECT.
Exemplo de registro
REST.PUT.OBJECT
Chave
A parte “chave” da solicitação, codificada pela URL ou “-”, se a operação não usar um parâmetro de chave.
Exemplo de registro
/photos/2019/08/puppy.jpg
Request-URI
A parte de Request-URI da mensagem de solicitação HTTP.
Entrada de exemplo
"GET /DOC-EXAMPLE-BUCKET/photos/2019/08/puppy.jpg?x-foo=bar HTTP/1.1"
Status HTTP
O código numérico do status do HTTP da resposta.
Exemplo de registro
200
Código de erro
O Error code (Código de erro) do Amazon S3 ou “-”, se nenhum erro tiver ocorrido.
Exemplo de registro
NoSuchBucket
Bytes enviados
O número de bytes de resposta enviados excluindo a sobrecarga do protocolo HTTP ou “-”, se zero.
Exemplo de registro
2662992
Tamanho do objeto
O tamanho total do objeto em questão.
Exemplo de registro
3462992
Tempo total
O número de milissegundos em que a solicitação esteve em andamento na perspectiva do bucket. Esse valor é medido do momento do recebimento da solicitação até o momento em que o último byte da resposta é enviado. As medidas feitas da perspectiva do cliente podem ser mais longas devido à latência da rede.
Exemplo de registro
70
Tempo de retorno
O número de milissegundos que o Lightsail gastou processando sua solicitação. Esse valor é medido do momento do recebimento do último byte da solicitação até o momento em que o primeiro byte da resposta foi enviado.
Exemplo de registro
10
Referer
O valor do cabeçalho do indicador HTTP, se presente. Os agentes do usuário HTTP (por exemplo, navegadores) normalmente definem esse cabeçalho como o URL da página de vinculação ou incorporação ao fazer uma solicitação.
Exemplo de registro
"http://www.amazon.com/webservices"
User-Agent
O valor do cabeçalho do agente de usuário do HTTP.
Exemplo de registro
"curl/7.15.1"
ID da versão
O ID da versão na solicitação ou - se a operação não usar um parâmetro de versionId.
Exemplo de registro
3HL4kqtJvjVBH40Nrjfkd
ID do host
O x-amz-id -2 ou o ID de solicitação estendida do Lightsail.
Exemplo de registro
s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234=
Versão do Signature
A versão do Signature, SigV2 ou SigV4, que foi usada para autenticar a solicitação ou - para solicitações não autenticadas.
Exemplo de registro
SigV2
Pacote de criptografia
A codificação Secure Sockets Layer (SSL) que foi negociada para a solicitação HTTPS ou - para HTTP.
Exemplo de registro
ECDHE-RSA-AES128-GCM-SHA256
Tipo de autenticação
O tipo da autenticação de solicitação usado, AuthHeader para cabeçalhos de autenticação, QueryString para string de consulta (pre-signed URL) ou - para solicitações não autenticadas.
Exemplo de registro
AuthHeader
Cabeçalho de host
O endpoint usado para se conectar ao Lightsail.
Exemplo de registro
s3.us-west-2.amazonaws.com
Versão do TLS
A versão do Transport Layer Security (TLS) negociada pelo cliente. O valor é um dos seguintes: TLSv1, TLSv1.1, TLSv1.2 ou - se o TLS não foi usado.
Exemplo de registro
TLSv1.2
Registro em log adicional para operações de cópia
Uma operação de cópia envolve um GET e um PUT. Por esse motivo, registramos dois registros em log ao executar uma operação de cópia. A seção anterior descreve os campos relacionados à parte PUT da operação. A lista a seguir descreve os campos no registro que se relacionam à parte GET da operação de cópia.
Proprietário do bucket
O ID canônico do usuário do bucket que armazena o objeto que está sendo copiado. O ID de usuário canônico é uma outra forma do ID da conta da AWS. Para mais informações sobre IDs canônicas de usuário, consulte AWS account identifiers (Identificadores de conta da AWS) na Referência geral da AWS. Para informações sobre como encontrar o ID canônico de usuário da conta, consulte Finding the canonical user ID for your AWS account (Como encontrar o ID de usuário canônico da conta da AWS).
Exemplo de registro
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
Bucket
O nome do bucket que armazena o objeto que está sendo copiado.
Exemplo de registro
DOC-EXAMPLE-BUCKET
Tempo
O horário em que a solicitação foi recebida. As datas e horas estão em Tempo Universal Coordenado (UTC). O formato que usa a terminologia strftime() é o seguinte: [%d/%B/%Y:%H:%M:%S %z]
Exemplo de registro
[06/Feb/2019:00:00:38 +0000]
IP remoto
O endereço de internet aparente do solicitante. Os proxies e os firewalls intermediários podem obscurecer o endereço real da máquina que faz a solicitação.
Exemplo de registro
192.0.2.3
Solicitante
O ID canônico do usuário do solicitante ou um - para solicitações não autenticadas. Se o solicitante for um usuário do IAM, esse campo retornará o nome do usuário do IAM do solicitante junto com a conta raiz da AWS à qual o usuário do IAM pertence. Esse identificador é o mesmo usado para fins de controle de acesso.
Exemplo de registro
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
ID da solicitação
Uma string gerada pelo Lightsail para identificar de forma exclusiva cada solicitação.
Exemplo de registro
3E57427F33A59F07
Operação
A operação listada aqui é declarada como SOAP., operationREST., HTTP_method.resource_typeWEBSITE. ou HTTP_method.resource_typeBATCH.DELETE.OBJECT.
Exemplo de registro
REST.COPY.OBJECT_GET
Chave
A “chave” do objeto que está sendo copiado ou “-”, se a operação não usar um parâmetro de chave.
Exemplo de registro
/photos/2019/08/puppy.jpg
Request-URI
A parte de Request-URI da mensagem de solicitação HTTP.
Exemplo de registro
"GET /DOC-EXAMPLE-BUCKET/photos/2019/08/puppy.jpg?x-foo=bar"
Status HTTP
O código numérico do status do HTTP da parte GET da operação de cópia.
Exemplo de registro
200
Código de erro
O código de erro do Amazon S3, da parte GET da operação de cópia ou -, se nenhum erro tiver ocorrido.
Exemplo de registro
NoSuchBucket
Bytes enviados
O número de bytes de resposta enviados excluindo a sobrecarga do protocolo HTTP ou “-”, se zero.
Exemplo de registro
2662992
Tamanho do objeto
O tamanho total do objeto em questão.
Exemplo de registro
3462992
Tempo total
O número de milissegundos em que a solicitação esteve em andamento na perspectiva do bucket. Esse valor é medido do momento do recebimento da solicitação até o momento em que o último byte da resposta é enviado. As medidas feitas da perspectiva do cliente podem ser mais longas devido à latência da rede.
Exemplo de registro
70
Tempo de retorno
O número de milissegundos que o Lightsail gastou processando sua solicitação. Esse valor é medido do momento do recebimento do último byte da solicitação até o momento em que o primeiro byte da resposta foi enviado.
Exemplo de registro
10
Referer
O valor do cabeçalho do indicador HTTP, se presente. Os agentes do usuário HTTP (por exemplo, navegadores) normalmente definem esse cabeçalho como o URL da página de vinculação ou incorporação ao fazer uma solicitação.
Exemplo de registro
"http://www.amazon.com/webservices"
User-Agent
O valor do cabeçalho do agente de usuário do HTTP.
Exemplo de registro
"curl/7.15.1"
ID da versão
O ID da versão do objeto que está sendo copiado ou -, se o cabeçalho x-amz-copy-source não tiver especificado um parâmetro de versionId como parte da fonte da cópia.
Exemplo de registro
3HL4kqtJvjVBH40Nrjfkd
ID do host
O x-amz-id -2 ou o ID de solicitação estendida do Lightsail.
Exemplo de registro
s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234=
Versão do Signature
A versão do Signature, SigV2 ou SigV4, que foi usada para autenticar a solicitação ou - para solicitações não autenticadas.
Exemplo de registro
SigV2
Pacote de criptografia
A codificação Secure Sockets Layer (SSL) que foi negociada para a solicitação HTTPS ou - para HTTP.
Exemplo de registro
ECDHE-RSA-AES128-GCM-SHA256
Tipo de autenticação
O tipo de autenticação de solicitação usada,AuthHeader para cabeçalhos de autenticação, QueryString para string de consulta (pre-signed URL) ou um - para solicitações não autenticadas.
Exemplo de registro
AuthHeader
Cabeçalho de host
O endpoint usado para se conectar ao Lightsail.
Exemplo de registro
s3.us-west-2.amazonaws.com
Versão do TLS
A versão do Transport Layer Security (TLS) negociada pelo cliente. O valor é um dos seguintes: TLSv1, TLSv1.1, TLSv1.2 ou - se o TLS não foi usado.
Exemplo de registro
TLSv1.2
Informações personalizadas do log de acesso
Você pode incluir informações personalizadas a serem armazenadas no registro de log de acesso de uma solicitação. Para fazer isso, adicione um parâmetro de string de consulta personalizado à URL da solicitação. O Lightsail ignora os parâmetros da sequência de caracteres de consulta que começam com “x-”, mas inclui esses parâmetros no registro de log de acesso da solicitação, como parte do campo do registro de Request-URI log.
Por exemplo, uma solicitação GET para "s3.amazonaws.com/DOC-EXAMPLE-BUCKET/photos/2019/08/puppy.jpg?x-user=johndoe" funciona da mesma forma que a solicitação para "s3.amazonaws.com/DOC-EXAMPLE-BUCKET/photos/2019/08/puppy.jpg", exceto pelo fato de que a string "x-user=johndoe" está incluída no campo Request-URI do registro de log associado. Essa funcionalidade está disponível apenas na interface REST.
Considerações sobre programação para o formato extensível do log de acesso
Ocasionalmente, podemos estender o formato de registro de log de acesso adicionando novos campos ao final de cada linha. Portanto, você deve criar qualquer código que analise logs de acesso para processar os campos finais que talvez ele não entenda.
