logs

Creates, updates, deletes, gets or lists a logs resource.

Overview

Name	logs
Type	Resource
Id	cloudflare.ai_gateway.logs

Fields

The following fields are returned by SELECT queries:

get

Returns the log details

Name	Datatype	Description
id	string
cached	boolean
cost	number
created_at	string (date-time)
custom_cost	boolean
duration	integer
metadata	string
model	string
model_type	string
path	string
provider	string
request_content_type	string
request_head	string
request_head_complete	boolean
request_size	integer
request_type	string
response_content_type	string
response_head	string
response_head_complete	boolean
response_size	integer
status_code	integer
step	integer
success	boolean
tokens_in	integer
tokens_out	integer

list

Returns a list of Gateway Logs

Name	Datatype	Description
id	string
cached	boolean
cost	number
created_at	string (date-time)
custom_cost	boolean
duration	integer
metadata	string
model	string
model_type	string
path	string
provider	string
request_content_type	string
request_type	string
response_content_type	string
status_code	integer
step	integer
success	boolean
tokens_in	integer
tokens_out	integer

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	id, gateway_id, account_id		Retrieves detailed information for a specific AI Gateway log entry.
list	select	account_id, gateway_id	search, page, per_page, order_by, order_by_direction, filters, meta_info, direction, start_date, end_date, min_cost, max_cost, min_tokens_in, max_tokens_in, min_tokens_out, max_tokens_out, min_total_tokens, max_total_tokens, min_duration, max_duration, feedback, success, cached, model, model_type, provider, request_content_type, response_content_type
edit	update	id, gateway_id, account_id		Updates metadata for an AI Gateway log entry.
delete	delete	account_id, gateway_id	order_by, order_by_direction, filters, limit
list_logs_request	exec	id, gateway_id, account_id		Retrieves the original request payload for an AI Gateway log entry.
list_logs_response	exec	id, gateway_id, account_id		Retrieves the response payload for an AI Gateway log entry.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
gateway_id	string	The AI Gateway ID.
id	string	Resource ID.
cached	boolean
direction	string
end_date	string (date-time)
feedback	number
filters	array
limit	integer
max_cost	number
max_duration	number
max_tokens_in	number
max_tokens_out	number
max_total_tokens	number
meta_info	boolean
min_cost	number
min_duration	number
min_tokens_in	number
min_tokens_out	number
min_total_tokens	number
model	string
model_type	string
order_by	string
order_by_direction	string
page	integer
per_page	integer
provider	string
request_content_type	string
response_content_type	string
search	string
start_date	string (date-time)
success	boolean

SELECT examples

get

Retrieves detailed information for a specific AI Gateway log entry.

SELECT
id,
cached,
cost,
created_at,
custom_cost,
duration,
metadata,
model,
model_type,
path,
provider,
request_content_type,
request_head,
request_head_complete,
request_size,
request_type,
response_content_type,
response_head,
response_head_complete,
response_size,
status_code,
step,
success,
tokens_in,
tokens_out
FROM cloudflare.ai_gateway.logs
WHERE id = '{{ id }}' -- required
AND gateway_id = '{{ gateway_id }}' -- required
AND account_id = '{{ account_id }}' -- required
;

list

Returns a list of Gateway Logs

SELECT
id,
cached,
cost,
created_at,
custom_cost,
duration,
metadata,
model,
model_type,
path,
provider,
request_content_type,
request_type,
response_content_type,
status_code,
step,
success,
tokens_in,
tokens_out
FROM cloudflare.ai_gateway.logs
WHERE account_id = '{{ account_id }}' -- required
AND gateway_id = '{{ gateway_id }}' -- required
AND search = '{{ search }}'
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND order_by = '{{ order_by }}'
AND order_by_direction = '{{ order_by_direction }}'
AND filters = '{{ filters }}'
AND meta_info = '{{ meta_info }}'
AND direction = '{{ direction }}'
AND start_date = '{{ start_date }}'
AND end_date = '{{ end_date }}'
AND min_cost = '{{ min_cost }}'
AND max_cost = '{{ max_cost }}'
AND min_tokens_in = '{{ min_tokens_in }}'
AND max_tokens_in = '{{ max_tokens_in }}'
AND min_tokens_out = '{{ min_tokens_out }}'
AND max_tokens_out = '{{ max_tokens_out }}'
AND min_total_tokens = '{{ min_total_tokens }}'
AND max_total_tokens = '{{ max_total_tokens }}'
AND min_duration = '{{ min_duration }}'
AND max_duration = '{{ max_duration }}'
AND feedback = '{{ feedback }}'
AND success = '{{ success }}'
AND cached = '{{ cached }}'
AND model = '{{ model }}'
AND model_type = '{{ model_type }}'
AND provider = '{{ provider }}'
AND request_content_type = '{{ request_content_type }}'
AND response_content_type = '{{ response_content_type }}'
;

UPDATE examples

edit

Updates metadata for an AI Gateway log entry.

UPDATE cloudflare.ai_gateway.logs
SET 
feedback = {{ feedback }},
metadata = '{{ metadata }}',
score = {{ score }}
WHERE 
id = '{{ id }}' --required
AND gateway_id = '{{ gateway_id }}' --required
AND account_id = '{{ account_id }}' --required
RETURNING
result,
success;

DELETE examples

delete

No description available.

DELETE FROM cloudflare.ai_gateway.logs
WHERE account_id = '{{ account_id }}' --required
AND gateway_id = '{{ gateway_id }}' --required
AND order_by = '{{ order_by }}'
AND order_by_direction = '{{ order_by_direction }}'
AND filters = '{{ filters }}'
AND limit = '{{ limit }}'
;

Lifecycle Methods

list_logs_request

Retrieves the original request payload for an AI Gateway log entry.

EXEC cloudflare.ai_gateway.logs.list_logs_request 
@id='{{ id }}' --required, 
@gateway_id='{{ gateway_id }}' --required, 
@account_id='{{ account_id }}' --required
;

list_logs_response

Retrieves the response payload for an AI Gateway log entry.

EXEC cloudflare.ai_gateway.logs.list_logs_response 
@id='{{ id }}' --required, 
@gateway_id='{{ gateway_id }}' --required, 
@account_id='{{ account_id }}' --required
;