Skip to content

Conversation

patrickbirch
Copy link
Collaborator

Your branch is up to date with 'origin/8.0'.
modified: docs/audit-log-filter-variables.md

@it-percona it-percona temporarily deployed to ps-10193-8.0 - percona-server-docs-8.0 PR #575 September 23, 2025 14:29 — with Render Destroyed
Your branch is up to date with 'origin/8.0'.
	modified:   docs/audit-log-filter-variables.md
Auditlog functions always accept and return strings in `utf8mb4`.

The following audit log filter functions are available.
!!! warning "Plugin Compatibility"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Plugin compatibility


The following sections describe the audit log filter plugin functionality organized by purpose:

## Plugin Management
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Plugin management

| [`audit_log_filter_disable`](#audit_log_filter_disable) | Variable | Disable plugin logging |

`keyring_id` - If the function does not contain a keyring_id, the function returns the current encryption password. You can also request a specific encryption password with the keyring ID of either the current password or an archived password.
## Filter Management
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Filter management

| [`audit_log_filter_filter_id`](#audit_log_filter_filter_id) | Variable | Current session filter ID |

#### Example
## Log Reading and Navigation
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Log reading and navigation

| {"password":"passw0rd","iterations":5689} |
+---------------------------------------------+
```
## Log File Management
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Log file management

#### Parameters

If this function is used with [`audit_log_read()](#audit_log_read), the `audit_log_read()` function starts reading at that position.
* `filter_name` - a selected filter name as a string.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should have the same format everywhere. Previously, the first word after the hyphen started with a capital letter, for example, * ON - Load the plugin if it is available (line 123), * FORCE - Load the plugin even if it has been disabled (line 127)

I suggest using lowercase after the hyphen everywhere.

* `filter_name` - a selected filter name as a string.

#### Parameters
* `definition` - The filter definition as a `JSON` value. The `JSON` structure defines
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use lowercase after the hyphen since the previous bullet also uses lowercase

filter_name - a selected filter name as a string.

The new filter has a different filter ID. Generates an error if the filter name exists.
The default value is 0 (zero) - the session has no assigned filter.

## Log Reading and Navigation
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Log reading and navigation

* OFF
* FORCE
* FORCE_PLUS_PERMANENT
## Log File Management
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Log file management

| SYNCHRONOUS | Calls sync() after each event (safest, slowest performance) |

Pruning requires the following options:
## Encryption and Security
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Encryption and security

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants