Skip to main content

# kater logs job

Shows one job run's result: its state and times, and what the sync or the test run answered.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

Use it to find out why a run failed.

## Examples

```bash
# Find the id of the last sync_snowflake run
kater job history --kater-root . --deployment production --job sync_snowflake --limit 1
# Show that run's result, by its id
kater logs job 0f3c9a6e2b8d4f17a5c1e9b04d72a6c3 --kater-root . --deployment production
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<run-id>` | The run, by the `id` that `kater job history` gives. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--deployment <name>` | Required. The deployment the run belongs to, such as `production`. A run of another deployment is not found. |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## What the result holds

`result` holds the answer of `kater sync` or `kater test`, with its diagnostics. A run that did not do its work gives a code in place of the answer, such as `job_changed` or `worker_interrupted`. A credential that needs a browser sign-in gives the diagnostic `interactive_credentials`.

## See also

- [`kater logs`](https://kater.ai/docs/cli-reference/logs/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
What the result holds
See also

Kater CLI Logs and bugs logs

kater logs job

Shows one job run's result: its state and times, and what the sync or the test run answered.

Use it to find out why a run failed.

Examples

# Find the id of the last sync_snowflake run
kater job history --kater-root . --deployment production --job sync_snowflake --limit 1
# Show that run's result, by its id
kater logs job 0f3c9a6e2b8d4f17a5c1e9b04d72a6c3 --kater-root . --deployment production

Arguments

Argument	Description
`<run-id>`	The run, by the `id` that `kater job history` gives.

Options

Option	Description
`--deployment <name>`	Required. The deployment the run belongs to, such as `production`. A run of another deployment is not found.

It also takes the global options --json, --kater-root, --scope and --help.

What the result holds

result holds the answer of kater sync or kater test, with its diagnostics. A run that did not do its work gives a code in place of the answer, such as job_changed or worker_interrupted. A credential that needs a browser sign-in gives the diagnostic interactive_credentials.

See also