Log Analysis

Prerequisites

APIs have been called.

Procedure

1. Go to the APIG console.
2. Select a gateway at the top of the navigation pane.
3. In the navigation pane, choose Monitoring & Analysis > Log Analysis.

4. Click Configure Log Collection, and change Collect Logs to to enable log collection.

5. Specify a log group and log stream, and click OK. For details about log groups and log streams, see section "Log Management" in the Log Tank Service User Guide.
6. Click Log Fields to view the description of each log field. Then view and analyze logs by referring to the log field descriptions.
7. To export logs, see section "Log Transfer" in the Log Tank Service User Guide.

   Fields in access logs are separated using spaces. The following table describes each log field.

   Table 1 Log field description

   No.	Field	Description
   1	remote_addr	Client IP address.
   2	request_id	Request ID.
   3	api_id	API ID
   4	user_id	Project ID provided by a requester for IAM authentication.
   5	app_id	App ID provided by a requester for app authentication.
   6	time_local	Time when a request is received.
   7	request_time	Request latency.
   8	request_method	HTTP request method.
   9	host	Domain name.
   10	router_uri	Request URI.
   11	server_protocol	Request protocol.
   12	status	Response status code.
   13	bytes_sent	Response size in bytes, including the status line, header, and body.
   14	request_length	Request length in bytes, including the start line, header, and body.
   15	http_user_agent	User agent ID.
   16	http_x_forwarded_for	X-Forwarded-For header field.
   17	upstream_addr	Backend address.
   18	upstream_uri	Backend URI.
   19	upstream_status	Backend response code.
   20	upstream_connect_time	Time taken to establish a connection with the backend.
   21	upstream_header_time	Duration from the start of a connection to the first byte received from the backend.
   22	upstream_response_time	Duration from the start of a connection to the last byte received from the backend.
   23	region_id	Region ID.
   24	all_upstream_response_time	Duration from the start of a connection to the last byte received from the backend, in seconds. When a retry occurs, the value is the total time taken.
   25	errorType	API request error type. Options: 0: non-throttling error 1: throttling error
   26	auth_type	API authentication mode.
   27	access_model1	Authentication mode 1.
   28	access_model2	Authentication mode 2. Enabling two-factor authentication will use the custom authorizer ID.
   29	inner_time	APIG internal processing duration, in seconds.
   30	proxy_protocol_vni	VPC endpoint virtual network ID.
   31	proxy_protocol_vpce_id	VPC endpoint ID.
   32	proxy_protocol_addr	Client IP address.
   33	body_bytes_sent	API request body size, in bytes.
   34	api_name	API name.
   35	app_name	Name of the app used by a requester for authentication.
   36	provider_app_id	App ID of an API.
   37	provider_app_name	App name of an API.
   38	custom_data_log1	Custom log field 1.
   39	custom_data_log2	Custom log field 2.
   40	custom_data_log3	Custom log field 3.
   41	custom_data_log4	Custom log field 4.
   42	custom_data_log5	Custom log field 5.
   43	custom_data_log6	Custom log field 6.
   44	custom_data_log7	Custom log field 7.
   45	custom_data_log8	Custom log field 8.
   46	custom_data_log9	Custom log field 9.
   47	custom_data_log10	Custom log field 10.
   48	response_source	Response source. Options: local: APIG remote: backend service
   51	group_id	Group ID.
   52	apig_err_code	Gateway error code.