本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon VPC Lattice 的存取日誌

存取日誌會擷取 VPC Lattice 服務和資源組態的詳細資訊。您可以使用這些存取日誌來分析流量模式，並稽核網路中的所有服務。對於 VPC Lattice 服務，我們會發佈 VpcLatticeAccessLogs ，對於資源組態，我們會發佈VpcLatticeResourceAccessLogs需要單獨設定的 。

存取日誌是選用的，預設為停用。啟用存取日誌之後，您可以隨時停用它們。

定價

發佈存取日誌時需支付費用。 AWS 代表您原生發佈的日誌稱為付費日誌。如需付費日誌定價的詳細資訊，請參閱 Amazon CloudWatch 定價、選擇日誌，並在已付費日誌下檢視定價。

啟用存取日誌所需的 IAM 許可

若要啟用存取日誌並將日誌傳送到其目的地，您必須在政策中將下列動作連接到您正在使用的 IAM 使用者、群組或角色。

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Sid": "ManageVPCLatticeAccessLogSetup",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:GetLogDelivery",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:ListLogDeliveries",
                "vpc-lattice:CreateAccessLogSubscription",
                "vpc-lattice:GetAccessLogSubscription",
                "vpc-lattice:UpdateAccessLogSubscription",
                "vpc-lattice:DeleteAccessLogSubscription",
                "vpc-lattice:ListAccessLogSubscriptions"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}            

如需詳細資訊，請參閱《AWS Identity and Access Management 使用者指南》中的新增和移除 IAM 身分許可。

更新連接至您正在使用的 IAM 使用者、群組或角色的政策後，請前往 啟用存取日誌。

存取日誌目的地

您可以將存取日誌傳送至下列目的地。

啟用存取日誌

完成下列程序來設定存取日誌，以擷取存取日誌並將其交付至您選擇的目的地。

使用主控台啟用存取日誌

您可以在建立期間啟用服務網路、服務或資源組態的存取日誌。您也可以在建立服務網路、服務或資源組態後啟用存取日誌，如下列程序所述。

使用 啟用存取日誌 AWS CLI

使用 CLI 命令 create-access-log-subscription 來啟用服務網路或服務的存取日誌。

請求追蹤

VPC Lattice 支援用戶端、目標和日誌之間的請求追蹤和關聯，以便使用 x-amzn-requestid 標頭進行可觀測性和偵錯。此標頭可由用戶端設定和傳送，或由 VPC Lattice 產生，並傳送至目標，也可用於存取日誌。

範例 （預設回應）

以下是傳送至用戶端的回應範例，其預設行為為 VPC Lattice 產生 x-amzn-requestid 標頭值的隨機值。

{
    "HTTP/1.1 200 OK
    x-amzn-requestid: a9f2c7a1-6b4f-4c79-9e87-ff5a1234a001"
}

範例 （覆寫用戶端請求）

以下是用戶端以標頭值傳送的請求範例。

{
    "GET /my-service/endpoint HTTP/1.1 
    Host: my-api.example.com
    x-amzn-requestid: trace-request-foobar"
}

範例 （預設覆寫回應）

以下是使用覆寫值傳送至用戶端的回應範例。

{
    "HTTP/1.1 200 OK
    x-amzn-requestid: trace-request-foobar"
}

存取日誌內容

下表說明存取日誌項目的欄位。

範例

以下為日誌項目的範例。

{
    "callerPrincipalTags" : "{ "TagA": "ValA", "TagB": "ValB", ... }",
    "hostHeader": "example.com",
    "sslCipher": "-",
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-west-2:123456789012:servicenetwork/svn-1a2b3c4d",
    "resolvedUser": "Unknown",
    "authDeniedReason": "null",
    "requestMethod": "GET",
    "targetGroupArn": "arn:aws:vpc-lattice:us-west-2:123456789012:targetgroup/tg-1a2b3c4d",
    "tlsVersion": "-",
    "userAgent": "-",
    "serverNameIndication": "-",
    "destinationVpcId": "vpc-0abcdef1234567890",
    "sourceIpPort": "178.0.181.150:80",
    "targetIpPort": "131.31.44.176:80",
    "serviceArn": "arn:aws:vpc-lattice:us-west-2:123456789012:service/svc-1a2b3c4d",
    "sourceVpcId": "vpc-0abcdef1234567890",
    "requestPath": "/billing",
    "startTime": "2023-07-28T20:48:45Z",
    "protocol": "HTTP/1.1",
    "responseCode": 200,
    "bytesReceived": 42,
    "bytesSent": 42,
    "duration": 375,
    "requestToTargetDuration": 1,
    "responseFromTargetDuration": 1,
    "grpcResponseCode": 1,
    "requestId": "a9f2c7a1-6b4f-4c79-9e87-ff5a1234a001"
}

資源存取日誌內容

下表說明資源存取日誌項目的欄位。

範例

以下為日誌項目的範例。

{
    "eventTimestamp": "2024-12-02T10:10:10.123Z",
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-west-2:1234567890:servicenetwork/sn-1a2b3c4d",
    "serviceNetworkResourceAssociationId": "snra-1a2b3c4d",
    "vpcEndpointId": "vpce-01a2b3c4d",
    "sourceVpcArn": "arn:aws:ec2:us-west-2:1234567890:vpc/vpc-01a2b3c4d",
    "resourceConfigurationArn": "arn:aws:vpc-lattice:us-west-2:0987654321:resourceconfiguration/rcfg-01a2b3c4d",
    "protocol": "tcp",
    "sourceIpPort": "172.31.23.56:44076",
    "destinationIpPort": "172.31.31.226:80",
    "gatewayIpPort": "10.0.28.57:49288",
    "resourceIpPort": "10.0.18.190:80"
}

對存取日誌進行故障診斷

本節包含您在存取日誌中可能看到的 HTTP 錯誤代碼說明。