The Audit Logs page

Prev Next

The Audit Logs page (Usage > Audit Logs) is visible only when the LogServer function has been configured on an appliance within the Collective. After you authenticate in AppGate ZTNA, you can access the LogServer directly using a link instead of navigating to Usage > Audit Logs each time.

Audit Logs redirects you to the LogServer, which uses OpenSearch as the UI engine. AppGate ZTNA provides preconfigured report scripts. The OpenSearch UI also provides tools to create custom data reports and visualizations of AppGate ZTNA performance.

For details about the log types that the AppGate ZTNA Collective generates, see the System monitoring and logs section. For information about audit log handling within AppGate ZTNA, see Audit log detail.


Using the LogServer

This section describes how to use OpenSearch and perform basic searches. For more information, see the OpenSearch User Guide.

Preconfigured tools

The menu at the top left includes OpenSearch Dashboards. The following dashboards are the most useful:

  • Dashboards. Two prepared dashboards are available: Appgate Appliances and Appgate User Activity.

  • Visualize. A list of prepared visualizations is available, including Client version used by OS and Configuration changes.

  • Discover. The main tool for performing log analysis. To access preconfigured search scripts, select Open at the top right of the screen

  • Pre-configured logserver scripts:

Pre-prepared search scripts including authentication and device claims.

  • Changing time-frame. To change the time frame for the audit log report, select the calendar button next to the displayed time window:

Time selection options for changing the time frame of an audit report.

  • Filtering the data

  • Changing parameters. You can add or remove the parameters included in a search report. For example, the "Controller Audit Logs" script displays the Time, DN, daemon, and event-type parameters.

Gateway audit logs displaying session events and timestamps for monitoring activity.

To add a parameter to the report: Locate the Available Fields list on the left side of the UI and select <+> next to the parameter you want to add.

To remove a parameter from the report: Locate the parameter in the Selected Fields list on the left and select <X> next to the parameter you want to remove.

Log analysis interface displaying event types and distinguished names with a bar chart.

  • Filtering searches. You can filter searches by expanding any field to display the most common values in that field. Use the + and - icons to include or exclude a value from the search. For example, select + next to cz-vpnd to display only cz-vpnd logs.

Logstash audit logs displaying event types and their corresponding counts over time.

  • Using the search bar. Enter search terms in the search bar to create custom searches. For example: event_type: ip_access && distinguished_name_user: testuser

You can also filter by value using the + and - icons to include or exclude a specific value. For example, set the type filter to authentication_succeeded and the value filter to Annie.

Audit logs displaying event types and timestamps for various daemons and distinguished names.