> ## Documentation Index
> Fetch the complete documentation index at: https://kosli-29-automate-helm-reference-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# kosli log environment

> List environment events.

## Synopsis

```shell theme={"theme":"dracula"}
kosli log environment ENV_NAME [flags]
```

List environment events.
The results are paginated and ordered from latest to oldest.
By default, the page limit is 15 events per page.

You can optionally specify an INTERVAL between two snapshot expressions with \[expression]..\[expression].

Expressions can be:

* \~N   N'th behind the latest snapshot
* N    snapshot number N
* NOW  the latest snapshot

Either expression can be omitted to default to NOW.

## Flags

| Flag                  | Description                                                                                 |
| :-------------------- | :------------------------------------------------------------------------------------------ |
| -h, --help            | help for environment                                                                        |
| -i, --interval string | \[optional] Expression to define specified snapshots range.                                 |
| -o, --output string   | \[defaulted] The format of the output. Valid formats are: \[table, json]. (default "table") |
| --page int            | \[defaulted] The page number of a response. (default 1)                                     |
| -n, --page-limit int  | \[defaulted] The number of elements per page. (default 15)                                  |
| --repo strings        | \[optional] The name of a git repo as it is registered in Kosli. e.g kosli-dev/cli          |
| --reverse             | \[defaulted] Reverse the order of output list.                                              |

## Flags inherited from parent commands

| Flag                      | Description                                                                                                                                      |
| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------- |
| -a, --api-token string    | The Kosli API token.                                                                                                                             |
| -c, --config-file string  | \[optional] The Kosli config file path. (default "kosli")                                                                                        |
| --debug                   | \[optional] Print debug logs to stdout. A boolean flag [docs](/faq/#boolean-flags) (default false)                                               |
| -H, --host string         | \[defaulted] The Kosli endpoint. (default "[https://app.kosli.com](https://app.kosli.com)")                                                      |
| --http-proxy string       | \[optional] The HTTP proxy URL including protocol and port number. e.g. '[http://proxy-server-ip:proxy-port](http://proxy-server-ip:proxy-port)' |
| -r, --max-api-retries int | \[defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)                                          |
| --org string              | The Kosli organization.                                                                                                                          |

## Live Example

To view a live example of 'kosli log environment' you can run the commands below (for the <a href="https://app.kosli.com/cyber-dojo/environments/aws-prod/snapshots/">cyber-dojo</a> demo organization).<br /><a href="https://app.kosli.com/api/v2/livedocs/cyber-dojo/cli?command=kosli+log+environment+aws-prod+--output=json">Run the commands below and view the output.</a><pre>export KOSLI\_ORG=cyber-dojo
export KOSLI\_API\_TOKEN=Pj\_XT2deaVA6V1qrTlthuaWsmjVt4eaHQwqnwqjRO3A  # read-only
kosli log environment aws-prod --output=json</pre>

## Examples Use Cases

These examples all assume that the flags  `--api-token`, `--org`, `--host`, (and `--flow`, `--trail` when required), are [set/provided](/getting_started/install/#assigning-flags-via-environment-variables).

<AccordionGroup>
  <Accordion title="list the last 15 events for an environment">
    ```shell theme={"theme":"dracula"}
    kosli log environment yourEnvironmentName 

    ```
  </Accordion>

  <Accordion title="list the last 30 events for an environment">
    ```shell theme={"theme":"dracula"}
    kosli log environment yourEnvironmentName 
    	--page-limit 30 

    ```
  </Accordion>

  <Accordion title="list the last 30 events for an environment (in JSON)">
    ```shell theme={"theme":"dracula"}
    kosli log environment yourEnvironmentName 
    	--page-limit 30 
    	--output json

    ```
  </Accordion>

  <Accordion title="list events for an environment filtered by repo">
    ```shell theme={"theme":"dracula"}
    kosli log environment yourEnvironmentName 
    	--repo yourOrg/yourRepo 

    ```
  </Accordion>

  <Accordion title="list events for an environment filtered by multiple repos">
    ```shell theme={"theme":"dracula"}
    kosli log environment yourEnvironmentName 
    	--repo yourOrg/yourRepo1 
    	--repo yourOrg/yourRepo2 
    ```
  </Accordion>
</AccordionGroup>