> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-1.5/command-line-reference/footprints.md).

# Footprints

A Footprint is a record of a test execution in Tosca or Tosca Cloud. If you've connected Tosca to SeaLights, you can configure the ABAP Agent to collect Footprints data. When you run a test in Tosca, the Agent matches the executable ABAP components you ran against objects in the latest Build Modification. The agent sends this data to SeaLights in a Footprint.

## Collect Footprint data

The `footprints run` command lets you collect Footprint data for a Pipeline.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe footprints run --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe footprints run --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}
{% endtabs %}

| Parameter    | Required | Description                                      |
| ------------ | -------- | ------------------------------------------------ |
| `--pipeline` | Yes      | The Pipeline name (as shown in `pipeline list`). |

### Example

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
slabapcli.exe footprints run --pipeline "HH_SLABAPCLI_170625"
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}

```powershell
.\slabapcli.exe footprints run --pipeline 'HH_SLABAPCLI_170625'
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

```log
.\slabapcli.exe footprints run --pipeline 'HH_SLABAPCLI_170625'
[2025-06-18 15:07:58.337+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-18 15:07:58.337+01:00] [info] Config pathname: ../config/config.toml
[2025-06-18 15:07:58.341+01:00] [info] resource = footprints. command = run
[2025-06-18 15:07:58.341+01:00] [info] pipline: HH_SLABAPCLI_170625
[2025-06-18 15:07:58.370+01:00] [info] Run scheduled daily. interval = 5m. duration = 1d
[2025-06-18 15:07:58.370+01:00] [info] Total time: 00:00:00.033
```

{% endcode %}

## Filter Footprint data

You can exclude specific SCMON context objects from footprints collection using the `typequeries` field in the `[footprints]` section of `config.toml`. This is useful if you want to filter out standard SAP programs, transactions, or function modules that aren't relevant to your testing.

See [Configuration settings — Footprints type queries](https://github.com/Sealights/gitbook.setupandconfiguration/blob/master/sealights-agents-and-plugins/abap-agent-1.5/configuration-settings.md) for syntax and examples.

{% hint style="info" %}
**TODO (from v1.5 draft):** Confirm the link target for "Configuration settings — Footprints type queries" once that page exists in the v1.5 section.
{% endhint %}

## Stop Footprint data collection

The `footprints stop` command stops the collection of Footprint data for a Pipeline. When you stop or replace a Footprints task, the Agent automatically stops any watcher process for that task.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
slabapcli.exe footprints stop --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\slabapcli.exe footprints stop --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}
{% endtabs %}

| Parameter    | Required | Description                                      |
| ------------ | -------- | ------------------------------------------------ |
| `--pipeline` | Yes      | The Pipeline name (as shown in `pipeline list`). |

### Example

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
slabapcli.exe footprints stop --pipeline "HH_SLABAPCLI_170625"
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}

```powershell
.\slabapcli.exe footprints stop --pipeline 'HH_SLABAPCLI_170625'
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}

```log
.\slabapcli.exe footprints stop --pipeline 'HH_SLABAPCLI_170625'
[2025-06-20 10:06:45.590+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 10:06:45.590+01:00] [info] Config pathname: ../config/config.toml
[2025-06-20 10:06:45.594+01:00] [info] resource = footprints. command = run
[2025-06-20 10:06:45.606+01:00] [info] Stopped footprints run
[2025-06-20 10:06:45.606+01:00] [info] Total time: 00:00:00.017
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-1.5/command-line-reference/footprints.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.