取得 的 Amazon S3 請求 IDs AWS 支援

記錄器的類型和詳細程度會在 SDKOptions引數中的 SDK 初始化期間指定。下列範例會將詳細程度指定為 LogLevel::Debug。

預設記錄器會寫入檔案系統，並使用下列慣例將檔案命名為 aws_sdk_YYYY-MM-DD-HH.log。記錄器會在該小時建立新的檔案。

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

如需詳細資訊，請參閱如何開啟記錄功能？ 適用於 AWS GitHub 上 C++ wiki 的 SDK。

您可以使用 SDK for Go 來設定記錄。如需詳細資訊，請參閱《 適用於 Go 的 AWS SDK v2 開發人員指南》中的記錄。

您可以啟用特定請求或回應的記錄，以僅擷取和傳回相關標頭。若要執行此作業，請匯入 com.amazonaws.services.s3.S3ResponseMetadata 類別。如此一來，您就能將請求存放在變數中，然後再執行實際的要求。若要取得所記錄的請求或回應，請呼叫 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());

或者，您可以對每一個 Java 要求與回應使用詳細記錄功能。如需詳細資訊，請參閱《適用於 Java 的 AWS SDK 開發人員指南》中的詳細連線記錄。

適用於 JavaScript 的 AWS SDK 具有內建記錄器，因此您可以記錄使用它進行的 API 呼叫。若要在主控台中開啟記錄器並列印日誌項目，請將下列陳述式新增至您的程式碼：

AWS.config.logger = console;

如需詳細資訊，請參閱《 適用於 JavaScript 的 AWS SDK 開發人員指南》中的記錄 適用於 JavaScript 的 AWS SDK 通話。

使用 適用於 Kotlin 的 AWS SDK，您可以使用程式碼或環境設定來指定線路層級訊息的日誌模式。您可以設定 HTTP 請求和 HTTP 回應的日誌模式。

若要選擇加入其他記錄，請在建構服務用戶端時設定 logMode 屬性：

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

// ...

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

或者，您可以使用 環境變數來設定日誌模式：

export SDK_LOG_MODE=LogRequestWithBody|LogResponse

如需詳細資訊，請參閱《 適用於 Kotlin 的 AWS SDK 開發人員指南》中的記錄。

您可以使用內建記錄工具 適用於 .NET 的 SDK ，使用 設定System.Diagnostics記錄。如需詳細資訊，請參閱使用AWS 開發人員部落格文章記錄 適用於 .NET 的 SDK。

您可以在用戶端建構函數true中將偵錯選項設定為 ，以取得偵錯資訊，包括透過線路傳送的資料。

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

如需詳細資訊，請參閱適用於《適用於 PHP 的 AWS SDK 開發人員指南》中的如何得知網路上傳送哪些資料？。

使用 適用於 Python (Boto3) 的 AWS SDK，您可以記錄特定回應。您可以使用此功能僅擷取相關標頭。下列程式碼顯示如何將回應的部分記錄到檔案中：

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'])

您也可以擷取例外狀況，並在引發例外狀況時記錄相關資訊。如需詳細資訊，請參閱適用於 Python (Boto) 的AWS 開發套件 API 參考中的從錯誤回應中辨別實用的資訊。

此外，您可以使用下列程式碼，配置 Boto3 輸出詳細資訊偵錯記錄檔：

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

如需詳細資訊，請參閱適用於 Python (Boto) 的AWS 開發套件 API 參考中的 set_stream_logger。

您可以使用適用於 Ruby IDs。您可以使用下列程式碼在用戶端中啟用 HTTP 線路記錄：

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

您也可以在請求回應或錯誤中找到請求內容物件的請求 ID：

# 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]

如需詳細資訊，請參閱《 適用於 Ruby 的 AWS SDK 開發人員指南適用於 Ruby 的 AWS SDK 》中的使用用戶端的線路追蹤資訊進行偵錯。

若要啟用記錄，請新增tracing-subscriber木箱並在 Rust 應用程式中初始化木箱。

將追蹤程式庫新增至您的 Cargo.toml 檔案：

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

然後，在您的 Rust 程式碼中，先在主要函數中初始化記錄器，再呼叫任何 SDK 操作：

tracing_subscriber::fmt::init();

如需詳細資訊，請參閱《 適用於 Rust 的 AWS SDK 開發人員指南》中的在 中設定和使用記錄 適用於 Rust 的 AWS SDK。