tail

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

Overview

Name	tail
Type	Resource
Id	cloudflare.workers.tail

Fields

The following fields are returned by SELECT queries:

list

List Tails response.

Name	Datatype	Description
id	string	Identifier. (example: 023e105f4ecef8ad9ca31a8372d0c353)
expires_at	string
url	string

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	account_id, script_name		Get list of tails currently deployed on a Worker.
create	insert	account_id, script_name		Starts a tail that receives logs and exception from a Worker.
delete	delete	account_id, script_name, id		Deletes a tail from a Worker.

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.
id	string	Resource ID.
script_name	string	The Worker script name.

SELECT examples

list

Get list of tails currently deployed on a Worker.

SELECT
id,
expires_at,
url
FROM cloudflare.workers.tail
WHERE account_id = '{{ account_id }}' -- required
AND script_name = '{{ script_name }}' -- required
;

INSERT examples

create

Starts a tail that receives logs and exception from a Worker.

INSERT INTO cloudflare.workers.tail (
account_id,
script_name
)
SELECT 
'{{ account_id }}',
'{{ script_name }}'
RETURNING
errors,
messages,
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: tail
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the tail resource.
  - name: script_name
    value: "{{ script_name }}"
    description: Required parameter for the tail resource.

DELETE examples

delete

Deletes a tail from a Worker.

DELETE FROM cloudflare.workers.tail
WHERE account_id = '{{ account_id }}' --required
AND script_name = '{{ script_name }}' --required
AND id = '{{ id }}' --required
;