> For the complete documentation index, see [llms.txt](https://docs.valtimo.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valtimo.nl/configuration-guides/plugins/external-plugins/plugin-logs.md).

# Plugin logs

Every external plugin configuration keeps a log administrators can inspect: entries the plugin wrote itself, and a record of every outbound HTTP call it made to an external address. This is the first place to look when a plugin misbehaves — and a quick way to verify that its outbound traffic matches what was accepted.

***

## Viewing a configuration's logs

{% stepper %}
{% step %}
Expand **Admin** in the left sidebar and click **Plugins**
{% endstep %}

{% step %}
Open the row menu (⋮) of an external plugin configuration and click **Logs**

<figure><img src="https://3330064618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq5dx9HWFJGshztp4binE%2Fuploads%2Fgit-blob-221098cc608cf67c6a0429b96e7a1523135fb727%2F15-plugin-logs-modal.png?alt=media" alt=""><figcaption><p>Plugin logs</p></figcaption></figure>
{% endstep %}
{% endstepper %}

The list shows the timestamp, level, source, and message of each entry, newest first. Click a row to see the entry's structured details. Two filters narrow the list:

| Filter     | Values                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Level**  | Debug, Info, Warn, Error                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Source** | **Plugin** — entries the plugin wrote itself. **HTTP request** — the automatic record of every outbound call the plugin made to an external address: method, address (with credentials and query parameters stripped), response status, and duration. **GZAC API** — reserved for the plugin's calls back into Valtimo; integrations currently record those in their own service logs, so this filter matches no entries yet. |

{% hint style="info" %}
Because a plugin can only reach the external addresses that were accepted for it, the HTTP request records are auditable: an address you do not recognize in this log is a finding, not noise. Log entries are kept for a limited time (30 days by default, configurable on the plugin host).
{% endhint %}