Skip to main content

Cloudflare/logpush

@swamp/cloudflare/logpushv2026.11.16.1· AGPL-3.0-or-later· 5d agoBEHAVIORS
01README

Cloudflare logpush infrastructure models

02Release Notes
  • Updated: jobs
03Behaviors2
@swamp/cloudflare/logpush/jobsv2026.11.16.1jobs.ts

Global Arguments

ArgumentTypeDescription
account_id?stringCloudflare account ID (provide account_id or zone_id)
zone_id?stringCloudflare zone ID (provide account_id or zone_id)
destination_conf?stringUniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included. Sensitive: wire with a vault.get(...) expression to source it from a vault.
enabled?booleanFlag that indicates if the job is enabled.
filter?stringThe filters to select the events to include and/or remove from your logs. For more information, refer to [Filters](https://developers.cloudflare.com/logs/reference/filters/).
filter_attack_traffic?booleanWhen true, excludes DDoS attack traffic from logs. This option is supported for the `http_requests`, `firewall_events`, and `network_analytics_logs` datasets.
frequency?enumThis field is deprecated. Please use `max_upload_*` parameters instead. . The frequency at which Cloudflare sends batches of logs to your destination. Setting frequency to high sends your logs in larger quantities of smaller files. Setting frequency to low sends logs in smaller quantities of larger files.
kind?enumThe kind parameter (optional) is used to differentiate between Logpush and Edge Log Delivery jobs (when supported by the dataset).
logpull_options?stringThis field is deprecated. Use `output_options` instead. Configuration string. It specifies things like requested fields and timestamp formats. If migrating from the logpull api, copy the url (full url or just the query string) of your call here, and logpush will keep on making this call for you, setting start and end times appropriately.
max_upload_bytes?unionThe maximum uncompressed file size of a batch of logs. This setting value must be between `5 MB` and `1 GB`, or `0` to disable it. Note that you cannot set a minimum file size; this means that log files may be much smaller than this batch size.
max_upload_interval_seconds?unionThe maximum interval in seconds for log batches. This setting must be between 30 and 300 seconds (5 minutes), or `0` to disable it. Note that you cannot specify a minimum interval for log batches; this means that log files may be sent in shorter intervals than this.
max_upload_records?unionThe maximum number of log lines per batch. This setting must be between 1000 and 1,000,000 lines, or `0` to disable it. Note that you cannot specify a minimum number of log lines per batch; this means that log files may contain many fewer lines than this.
name?stringOptional human readable job name. Not unique. Cloudflare suggests. that you set this to a meaningful string, like the domain name, to make it easier to identify your job.
output_options?objectThe structured replacement for `logpull_options`. When including this field, the `logpull_option` field will be ignored.
ownership_challenge?stringOwnership challenge token to prove destination ownership. Sensitive: wire with a vault.get(...) expression to source it from a vault.
dataset?enumName of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
apiToken?stringCloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?stringCloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?stringCloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.
fn create()
Create a Jobs
fn get(id: string)
Get a Jobs
ArgumentTypeDescription
idstringThe ID of the Jobs
fn lookup(allowMissing?: boolean)
Look up an existing Jobs by matching global argument values and import it into state
ArgumentTypeDescription
allowMissing?booleanSucceed and record found: false in lookupResult when nothing matches, instead of failing
fn adopt(id: string)
Import an existing Jobs by ID into state for management
ArgumentTypeDescription
idstringThe ID of the Jobs to import
fn update(identifier?: string)
Update Jobs attributes
ArgumentTypeDescription
identifier?stringTarget a specific Jobs by id (e.g. one discovered by list)
fn delete(id: string)
Delete the Jobs
ArgumentTypeDescription
idstringThe ID of the Jobs
fn sync(identifier?: string)
Sync Jobs state from Cloudflare
ArgumentTypeDescription
identifier?stringTarget a specific Jobs by id (e.g. one discovered by list)

Resources

state(infinite)— Jobs resource state
lookupResult(infinite)— Outcome of the most recent lookup
@swamp/cloudflare/logpush/transformersv2026.11.08.1transformers.ts

Global Arguments

ArgumentTypeDescription
account_idstringCloudflare account ID
code?stringThe SQL transformer query. Maximum 32 KB. The query must contain a FROM clause referencing a valid logpush dataset.
description?stringOptional customer-provided description.
name?stringCustomer-provided name for identification.
apiToken?stringCloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?stringCloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?stringCloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.
fn create()
Create a Transformers
fn get(id: string)
Get a Transformers
ArgumentTypeDescription
idstringThe ID of the Transformers
fn lookup(allowMissing?: boolean)
Look up an existing Transformers by matching global argument values and import it into state
ArgumentTypeDescription
allowMissing?booleanSucceed and record found: false in lookupResult when nothing matches, instead of failing
fn adopt(id: string)
Import an existing Transformers by ID into state for management
ArgumentTypeDescription
idstringThe ID of the Transformers to import
fn update(identifier?: string)
Update Transformers attributes
ArgumentTypeDescription
identifier?stringTarget a specific Transformers by id (e.g. one discovered by list)
fn delete(id: string)
Delete the Transformers
ArgumentTypeDescription
idstringThe ID of the Transformers
fn sync(identifier?: string)
Sync Transformers state from Cloudflare
ArgumentTypeDescription
identifier?stringTarget a specific Transformers by id (e.g. one discovered by list)

Resources

state(infinite)— Transformers resource state
lookupResult(infinite)— Outcome of the most recent lookup
04Previous Versions19
2026.11.11.1AGPL-3.0-or-later
  • Updated: jobs
2026.11.08.1AGPL-3.0-or-later
  • Updated: transformers
2026.11.05.1AGPL-3.0-or-later
  • Updated: jobs
2026.10.28.1AGPL-3.0-or-later
  • Updated: jobs
2026.10.23.1AGPL-3.0-or-later
  • Updated: jobs
  • Updated: transformers
2026.10.20.1AGPL-3.0-or-later
  • Updated: jobs
  • Updated: transformers

Modified 2 behaviors

2026.10.16.1AGPL-3.0-or-later(was none)
2026.10.13.1
  • Updated: jobs
  • Updated: transformers
2026.09.29.2
  • Updated: jobs
  • Updated: transformers
2026.09.29.1
  • Updated: jobs
  • Updated: transformers
2026.09.09.1
  • Updated: jobs
2026.08.26.1
  • Updated: jobs
2026.08.25.2
  • Updated: jobs
  • Added: transformers

Added 1 behaviors

2026.08.25.1
  • Updated: jobs

Removed 1 behaviors

2026.08.15.1
  • Added: transformers

Added 1 behaviors

2026.07.24.1
  • Updated: jobs
2026.07.21.1
  • Updated: jobs
2026.07.18.2

Modified 1 behaviors

2026.06.24.1
  • Updated: jobs
05Stats
A
100 / 100
Downloads
43
Archive size
21.8 KB
Verified by Swamp
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels