> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bronto.io/llms.txt
> Use this file to discover all available pages before exploring further.

# bronto send

> Send events to Bronto from a message or stdin

Sends events to Bronto's ingestion API. With -m/--message it sends one event
and exits. Otherwise it reads NDJSON or plain-text lines from stdin and sends them
in batches capped by --batch-size and --batch-bytes. A partial batch is flushed
every --flush-interval, so 'tail -f access.log | bronto send -d app' delivers
lines soon after they are written. If a batch fails, the command stops and the
events in that batch are lost. Rerunning the command can send duplicates, because
batches are not deduplicated.

<Tip>
  * **Platform docs:** [docs.bronto.io/getting-started/quick-ingestion](https://docs.bronto.io/getting-started/quick-ingestion)
</Tip>

```sh theme={"dark"}
bronto send [flags]
```

#### Flags

| Flag | Short | Type | Default | Description |
| - | - | - | - | - |
| `--batch-bytes` | | int | `1048576` | max bytes per batch |
| `--batch-size` | | int | `500` | max events per batch |
| `--collection` | | string | | destination collection |
| `--dataset` | `-d` | string | | destination dataset (required) |
| `--flush-interval` | | duration | `1s` | flush a partial batch at least this often (min 100ms) |
| `--ingest-url` | | string | | override the ingestion URL (config: ingest\_url, env: BRONTO\_INGEST\_URL) |
| `--message` | `-m` | string | | send one event with this message and exit (stdin is ignored) |
| `--no-gzip` | | bool | | send request bodies uncompressed |
| `--tag` | | stringArray | | tag to attach, as key=value (repeatable) |

Also accepts the [global flags](/cli/reference/commands/global-flags).

#### Examples

```sh theme={"dark"}
bronto send -d app -m 'hello world'
tail -f access.log | bronto send -d app --collection prod
echo '{"message":"m","level":"warn"}' | bronto send -d app
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.