Skip to content

fix: add more options for accessing and visualizing pg audit logs #1079

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

fix: add more options for accessing and visualizing pg audit logs #1079

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2c86473
pg audit log access tools
wojcik-dorota Sep 18, 2025
49ec4b1
fix
wojcik-dorota Sep 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions docs/products/postgresql/concepts/pg-audit-logging.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -169,13 +169,15 @@ For information on all the configuration parameters, preview

### Collecting and visualizing logs

You can
[access your collected audit logs](/docs/products/postgresql/howto/use-pg-audit-logging)
either directly in the log output of your Aiven for PostgreSQL service or by integrating
with another service that allows monitoring and analyzing logs, such as Aiven for
OpenSearch®. To
[visualize your audit logs](/docs/products/postgresql/howto/use-pg-audit-logging), you can
use [OpenSearch Dashboards](/docs/products/opensearch/dashboards).
[Access and visualize collected audit logs](/docs/products/postgresql/howto/use-pg-audit-logging)
using one of the supported methods:

| Methodology | Accessing `pgaudit` logs | Visualizing `pgaudit` logs |
| :--- | :--- | :---
| Aiven for PostgreSQL | Log output from Aiven for PostgreSQL®| [OpenSearch Dashboards](/docs/products/opensearch/dashboards) |
| Aiven-native integration | [Aiven for OpenSearch®](/docs/products/opensearch/)| [OpenSearch Dashboards](/docs/products/opensearch/dashboards) |
| External integration | `rsyslog` | Third-party platforms: Datadog, Google Cloud Logging, Amazon CloudWatch Logs, and other syslog-compatible tools |
| Aiven for Apache Kafka | Kafka topic in Aiven for Apache Kafka | Requires a separate downstream tool to consume the log data from Aiven for Kafka and provide visualization |

### Disabling audit logging

Expand Down
24 changes: 17 additions & 7 deletions docs/products/postgresql/howto/use-pg-audit-logging.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -219,8 +219,10 @@ For more details on how to set up, configure, and use session audit logging, che

## Access your logs

Access your Aiven for PostgreSQL audit logs by integrating with an Aiven for OpenSearch®
service, which allows monitoring and analyzing logs.
Choose one of the
[tools or methods for accessing, monitoring, or analyzing your audit logs](/docs/products/postgresql/concepts/pg-audit-logging#collecting-and-visualizing-logs).

Example: **Aiven for OpenSearch®**

<Tabs groupId="group1">
<TabItem value="1" label="Aiven Console" default>
Expand Down Expand Up @@ -271,12 +273,20 @@ curl --request POST \

## Visualize your logs

If your logs are available in Aiven for OpenSearch, use
[OpenSearch Dashboards](/docs/products/opensearch/dashboards/get-started) to visualize the
logs.
Choose one of the
[tools or methods for visualizing your collected audit logs](/docs/products/postgresql/concepts/pg-audit-logging#collecting-and-visualizing-logs).

Example: **[OpenSearch Dashboards](/docs/products/opensearch/dashboards/get-started)**

To preview your audit logs in OpenSearch Dashboards, use the filtering tool: select
`AIVEN_AUDIT_FROM`, set its value to `pg`, and apply the filter.
1. Integrate your Aiven for PostgreSQL with Aiven for OpenSearch.
1. Go to OpenSearch Dashboards.
1. Set up **Index Pattern** to match your audit logs index.
1. Filter the audit logs.
1. Go to **Discover**.
1. Select your audit logs index pattern.
1. Use the filter tool: Set the value of `AIVEN_AUDIT_FROM` to `pg`.
1. Apply the filter.
1. Preview and analyze the logs.

<img src={AuditLogsOpenSearchDashboards} class="image"/>

Expand Down