Sazabi
CLI

sazabi log-sources

Command reference for sazabi log-sources.

sazabi log-sources — Manage log sources. Subcommands: providers, list, create, get, setup-instructions, enable, disable, delete.

sazabi log-sources

Manage log sources

sazabi log-sources <subcommand>
sazabi log-sources providers  # List providers and their setup modes
sazabi log-sources list  # List log sources
sazabi log-sources create <slug>  # One setup mode: creates
sazabi log-sources create <slug> --mode manual  # Two modes: send data to an endpoint
sazabi log-sources create <slug> --mode native --metadata '{...}'  # Two modes: connect your account
sazabi log-sources create cloudwatch --mode native --method cloudformation  # Account mode with a recipe
sazabi log-sources setup-instructions <slug>  # Setup instructions before anything exists
sazabi log-sources setup-instructions <log-source-id>  # Setup instructions with this source's values
sazabi log-sources get <log-source-id>  # Inspect one log source

sazabi log-sources providers

List supported log source providers

sazabi log-sources providers [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi log-sources providers  # List providers and their setup modes
sazabi log-sources providers --json  # Output as JSON

sazabi log-sources list

List log sources

sazabi log-sources list [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--providerstringNoFilter by provider slug
--project-idstringNoProject ID
sazabi log-sources list  # List log sources
sazabi log-sources list --provider <slug>  # Filter by provider

sazabi log-sources create

Create a log source

A provider offers one or two setup paths: connect your account (--mode native, with the provider's credentials in --metadata) or send data to an endpoint (--mode manual, which mints a keyed intake endpoint). A provider with one path needs no --mode. A provider with both and no --mode prints the two commands and creates nothing.

--mode native without --metadata prints how to get the credentials and the finish command. A provider with several ways to build the credential (CloudWatch) takes --method to print one recipe; --method never changes what is created.

sazabi log-sources create <slug> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--metadatastringNoJSON credentials for the account path (see metadataFields in log-sources providers --json)
--modestringNoSetup path: native (connect your account) or manual (send data to an endpoint); inferred from --metadata when omitted
--methodstringNoWhich credential recipe to print, for providers with several (CloudWatch: cloudformation, terraform, cli)
--project-idstringNoProject ID
sazabi log-sources create <slug>  # One setup mode: creates
sazabi log-sources create <slug> --mode manual  # Two modes: send data to an endpoint
sazabi log-sources create <slug> --mode native  # Two modes: print how to get the credentials
sazabi log-sources create <slug> --mode native --metadata '{...}'  # Two modes: connect your account
sazabi log-sources create cloudwatch --mode native --method cloudformation  # Account mode with a recipe

sazabi log-sources get

Get one log source

sazabi log-sources get <log-source-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi log-sources get <log-source-id>  # Inspect one log source: its log streams and endpoints

sazabi log-sources setup-instructions

Print the setup instructions for a provider or a log source

A provider slug prints the generic instructions for every setup path the provider offers. A log source ID prints the instructions for that log source's path with its own values filled in: the endpoint for an endpoint source, the credential recipe and the log-stream selection command for an account source.

sazabi log-sources setup-instructions <slug | log-source-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
--methodstringNoWhich credential recipe to print, for providers with several (CloudWatch: cloudformation, terraform, cli)
sazabi log-sources setup-instructions <slug>  # Setup instructions before anything exists
sazabi log-sources setup-instructions <log-source-id>  # Setup instructions with this source's values
sazabi log-sources setup-instructions <log-source-id> --method cloudformation  # One credential recipe (CloudWatch)

sazabi log-sources enable

Resume ingestion for a log source's log streams

sazabi log-sources enable <log-source-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi log-sources enable <log-source-id>  # Resume ingestion

sazabi log-sources disable

Pause ingestion for a log source's log streams

sazabi log-sources disable <log-source-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi log-sources disable <log-source-id>  # Pause ingestion

sazabi log-sources delete

Delete a log source

sazabi log-sources delete <log-source-id> [options]
FlagTypeRequiredDescription
--tokenstringNoOverride token
--api-base-urlstringNoOverride API base URL
--jsonbooleanNoOutput as JSON
sazabi log-sources delete <log-source-id>  # Delete a log source and deactivate its keys