# log

The `log` step type emits a structured Atmos log message — the same leveled, field-aware logging Atmos uses internally — so your custom commands and workflows produce consistent, machine-readable output.

```yaml
steps:
  - name: audit
    type: log
    level: info
    content: Starting deployment
    fields:
      component: vpc
      stack: plat-ue2-prod
```

## Fields

- **`content`**
  Required. Log message. Supports templates.
- **`level`**
  Optional log level: 
  `trace`
  , 
  `debug`
  , 
  `info`
  , 
  `warn`
  , 
  `warning`
  , or 
  `error`
  . Defaults to 
  `info`
  .
- **`fields`**
  Optional structured key-value fields. Values support templates.

The step result value is the resolved log message.