## logs tail

Establishes a direct connection with Stripe, allowing you to tail your test mode Stripe API request logs in real-time from your terminal.

Multiple filters can be used together and a log entry must match all filters to be shown.

When specifying a filter, multiple values can be provided as a comma-separated list. A log entry only needs to match one of the values.

> `logs tail` only supports displaying *test mode* request logs.

**Command:** `stripe logs tail`

### Flags

- `--filter-account <values>`
  Filter request logs by the source and destination account.
    - `connect_in`
      Incoming Connect requests.
    - `connect_out`
      Outgoing Connect requests.
    - `self`
      Non-Connect requests.

- `--filter-http-method <values>`
  Filter request logs by HTTP method.
    - `GET`
      HTTP GET requests.
    - `POST`
      HTTP POST requests.
    - `DELETE`
      HTTP DELETE requests.

- `--filter-ip-address <values>`
  Filter request logs by IP address.

- `--filter-request-path <values>`
  Filter request logs that directly match any Stripe path (e.g. `/v1/charges`).

- `--filter-request-status <values>`
  Filter request logs by the response status.
    - `SUCCEEDED`
      Requests that succeeded (HTTP 200, 201, 202 status codes).
    - `FAILED`
      Requests that failed (HTTP 4xx and 5xx status codes).

- `--filter-source <values>`
  Filter request logs by the source of each request.
    - `API`
      Requests created with the Stripe API.
    - `DASHBOARD`
      Requests created from the Dashboard.

- `--filter-status-code <values>`
  Filter request logs by HTTP status code.

- `--filter-status-code-type <values>`
  Filter request logs by the type of HTTP status code.
    - `2XX`
      HTTP 2xx status codes.
    - `4XX`
      HTTP 4xx status codes.
    - `5XX`
      HTTP 5xx status codes.

- `--format <value>`
  Specifies the output format for request logs.
    - `JSON`
      Output logs in JSON format.

### Examples

**Basic usage**

```sh
stripe logs tail
```

```
> Ready! You're now waiting to receive API request logs
2022-01-28 09:47:46 [200] POST /v1/customers [req_abc123]
2022-01-28 09:48:22 [200] POST /v1/charges [req_def456]
2022-01-28 09:48:58 [200] POST /v1/charges [req_ghi789]
...
```

**Use multiple log filters**

```sh
stripe logs tail \
    --filter-http-method POST \
    --filter-status-code-type 4XX
```

**Use multiple values for log filters**

```sh
stripe logs tail --filter-http-method GET,POST
```