Obter IDs de solicitação do Amazon S3 para o AWS Support

O tipo de registrador e a verbosidade são especificados durante a inicialização do SDK no argumento SDKOptions. O exemplo a seguir especifica o nível de verbosidade como LogLevel::Debug.

O registrador padrão gravará no sistema de arquivos e o arquivo será nomeado usando a seguinte convenção aws_sdk_YYYY-MM-DD-HH.log. O registrador cria um novo arquivo na hora.

Aws::SDKOptions options;
options.loggingOptions.logLevel = Aws::Utils::Logging::LogLevel::Debug;
Aws::InitAPI(options);
// ...
Aws::ShutdownAPI(options);

Para obter mais informações, consulte Como ativo o registro em log? no wiki do SDK da AWS para C++ no GitHub.

É possível configurar o registro em log usando o SDK para Go. Para obter mais informações, consulte Registro em log no Guia do desenvolvedor do AWS SDK para Go v2.

Você pode habilitar o log para solicitações ou respostas específicas, para obter e retornar apenas cabeçalhos relevantes. Para fazer isso, importe a classe com.amazonaws.services.s3.S3ResponseMetadata. Mais tarde, você pode armazenar a solicitação em uma variável antes de executar a solicitação real. Para obter a solicitação ou a resposta registrada em log, chame getCachedResponseMetadata(AmazonWebServiceRequest request).getRequestID().

PutObjectRequest req = new PutObjectRequest(bucketName, key, createSampleFile());
s3.putObject(req);
S3ResponseMetadata md = s3.getCachedResponseMetadata(req);
System.out.println("Host ID: " + md.getHostId() + " RequestID: " + md.getRequestId());

Como alternativa, você pode usar log detalhado de cada solicitação e resposta de Java. Para obter mais informações, consulte Registro em log detalhado no Guia do desenvolvedor do AWS SDK para Java.

O AWS SDK para JavaScript tem um registrador integrado para que você possa registrar chamadas de API feitas com ele. Para ativar o registrador e imprimir entradas de log no console, adicione a instrução a seguir ao seu código:

AWS.config.logger = console;

Para obter mais informações, consulte Registro de chamadas do AWS SDK para JavaScript no Guia do desenvolvedor do AWS SDK para JavaScript.

Com o AWS SDK para Kotlin, você pode especificar o modo de log para mensagens no nível da rede usando configurações de código ou ambiente. Você pode definir o modo de log para solicitações e respostas HTTP.

Para optar pelo registro em log adicional, defina a propriedade logMode ao criar um cliente de serviço:

import aws.smithy.kotlin.runtime.client.LogMode

// ...

val client = S3Client {
    // ...
    logMode = LogMode.LogRequestWithBody + LogMode.LogResponse
}

Como alternativa, você pode definir o modo de log usando uma variável de ambiente:

export SDK_LOG_MODE=LogRequestWithBody|LogResponse

Para obter mais informações, consulte Registro em log no Guia do desenvolvedor do AWS SDK para Kotlin.

É possível configurar o log com o SDK para .NET usando a ferramenta integrada de log System.Diagnostics. Para obter mais informações, consulte a postagem Registro em log com o SDK para .NET no Blog do desenvolvedor da AWS.

Você pode obter informações de depuração, incluindo os dados enviados pela rede, definindo a opção de depuração como true em um construtor de cliente.

$s3Client = new Aws\S3\S3Client([
    'region'  => 'us-standard',
    'version' => '2006-03-01',
    'debug'   => true
]);

Para obter mais informações, consulte Como posso ver quais dados são enviados pela rede? no Guia do desenvolvedor do AWS SDK para PHP.

Com o AWS SDK para Python (Boto3), você pode registrar respostas específicas. É possível usar esse recurso para capturar somente os cabeçalhos relevantes. O código a seguir mostra como registrar em log partes da resposta a um arquivo:

import logging
import boto3
logging.basicConfig(filename='logfile.txt', level=logging.INFO)
logger = logging.getLogger(__name__)
s3 = boto3.resource('s3')
response = s3.Bucket(bucket_name).Object(object_key).put()
logger.info("HTTPStatusCode: %s", response['ResponseMetadata']['HTTPStatusCode'])
logger.info("RequestId: %s", response['ResponseMetadata']['RequestId'])
logger.info("HostId: %s", response['ResponseMetadata']['HostId'])
logger.info("Date: %s", response['ResponseMetadata']['HTTPHeaders']['date'])

Também é possível capturar exceções e registrar em log informações relevantes quando uma exceção é gerada. Para obter mais informações, consulte Discernir informações úteis de respostas de erro na Referência de API do AWS SDK para Python (Boto).

Além disso, é possível configurar o Boto3 para gerar logs de depuração detalhados usando o seguinte código:

import logging
import boto3
boto3.set_stream_logger('', logging.DEBUG)

Para obter mais informações, consulte set_stream_logger na Referência de API do AWS SDK para Python (Boto).

É possível obter os IDs de solicitação usando o SDK para Ruby versão 3. Você pode ativar o registro em log de conexões HTTP em seu cliente usando o seguinte código:

s3 = Aws::S3::Client.new(http_wire_trace: true)

Você também pode encontrar o ID da solicitação do objeto de contexto da solicitação na resposta ou no erro da solicitação:

# Finding the request ID from an error:
begin
  s3.put_object(bucket: 'bucket', key: 'key', body: 'test')
rescue Aws::S3::Errors::ServiceError => e
  puts e.context[:request_id]
  puts e.context[:s3_host_id]
end

# Finding the request ID from a successful call:
resp = s3.put_object(bucket: 'bucket', key: 'key', body: 'test')
puts resp.context[:request_id]
puts resp.context[:s3_host_id]

Para obter mais informações, consulte Depuração usando informações de rastreamento de rede de um cliente do AWS SDK para Ruby no Guia do desenvolvedor do AWS SDK para Ruby.

Para habilitar o registro em log, adicione a caixa tracing-subscriber e inicialize-a na aplicação do Rust.

Adicione a biblioteca de rastreamento ao arquivo Cargo.toml:

tracing-subscriber = { version = "0.3", features = ["env-filter"] }

Em seguida, no código Rust, inicialize o registrador na função principal antes de chamar qualquer operação do SDK:

tracing_subscriber::fmt::init();

Para obter mais informações, consulte Configuração e uso de logs no AWS SDK para Rust no Guia do desenvolvedor do AWS SDK para Rust.