---
title: blossom logs
url: "/docs/reference/cli/logs/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/logs/
markdown_url: https://docs.blossom88.com/docs/reference/cli/logs.md
summary: Show logs
categories:
- cli
- reference
---

# blossom logs

Show logs

## Usage

    blossom logs [--follow] [--environment ENVIRONMENT] [--service SERVICE] [--process PROCESS] [--lines LINES] [--timestamps]

## Flags

| Flag | Description |
| --- | --- |
| `--follow, -f` | Follow logs in real time |
| `--environment, -e` | Environment id for app logs |
| `--service, -s` | Service id for service container logs |
| `--process, -p` | Process name for Environment logs |
| `--lines, -n` | Number of recent log lines to show. Default: 20. |
| `--timestamps` | Show log timestamps. Default: false. |

Examples:

    blossom logs --environment environment-100
    blossom logs --environment environment-100 -n 50
    blossom logs --environment environment-100 --timestamps
    blossom logs --environment environment-100 --process web --follow
    BLOSSOM_OUTPUT=json blossom logs --service service-100

Shows the 20 most recent log lines from a Blossom resource. Use `--follow` to
continue streaming.

Pass exactly one customer Product selector:

    blossom logs --environment environment-100   # App logs across Services
    blossom logs --service service-100           # one service container

`--process` narrows which process is streamed:

    blossom logs --environment environment-100 --process web

Environment logs default to the `web` process.

Use `--lines` or `-n` to change the initial 20-line window:

    blossom logs --environment environment-100 --lines 50
    blossom logs --environment environment-100 -n 50 --follow

When following, Blossom limits the initial batch and then prints new entries as
they arrive.

Use `--timestamps` when timing matters, such as deploys or longer-running
service work.

Blossom uses the terminal's local timezone for text timestamps. On a remote
devbox, that may be UTC. Set `BLOSSOM_TIMEZONE` when you want local timestamps:

    BLOSSOM_TIMEZONE=America/Los_Angeles blossom logs --environment environment-100 --timestamps

Use `--follow` or `-f` to keep the stream open. While following, Blossom keeps
the stream refreshed as Containers are added, removed, or replaced.