Viewing a Log File (asg log)

Description

Use the "asg log" command in the Expert mode to see the contents of a specified log file.

Syntax

asg log [-b <SGM IDs>] --file <Log File> [--from "<Timestamp>"] [--to "<Timestamp>"] [--tail <N>] [--filter <String>]

Parameters

Parameter

Description

-b <SGM IDs>

Applies to Security GroupClosed A logical group of Security Appliances that provides Active/Active cluster functionality. A Security Group can contain one or more Security Appliances. Security Groups work separately and independently from each other. To the production networks, a Security Group appears a single Security Gateway. Every Security Group contains: (A) Applicable Uplink ports, to which your production networks are connected; (B) Security Appliances (the Quantum Maestro Orchestrator determines the applicable Downlink ports automatically); (C) Applicable management port, to which the Check Point Management Server is connected. Members as specified by the <SGM IDs>.

<SGM IDs> can be:

  • No <SGM IDs> specified, or all

    Applies to all Security Group Members and all Maestro Sites

  • One Security Group Member (for example, 1_1)

  • A comma-separated list of Security Group Members (for example, 1_1,1_4)

  • A range of Security Group Members (for example, 1_1-1_4)

  • In Dual Site, one Maestro Site (chassis1, or chassis2)

  • In Dual Site, the Active Maestro Site (chassis_active)

<Log File>

Specifies the log file by its type or full path:

  • audit

    If you specify the log type, the output shows all audit logs in the /var/log/ directory.

    To specify a log file, enter its full path and name.

    For example: /var/log/asgaudit.log.1

  • ports

    If you specify the log type, the output shows all ports logs in the /var/log/ directory.

    To specify a log file, enter its full path and name.

    For example: /var/log/ports

  • dist_mode

    If you specify the log type, the output shows all logs for the Distribution Mode activity.

    To specify a log file, enter its full path and name.

    For example: /var/log/dist_mode

    See Working with the Distribution Mode.

--from "<Timestamp>"

Shows only the log entries from the specified timestamp and above.

You must use the timestamp as it appears in the log file.

--to "<Timestamp>"

Shows only the log entries until the specified timestamp.

You must use the timestamp as it appears in the log file.

--tail <N>

Show only the last N lines of the log file for each Security Group Member.

For example, "-tail 3" shows only the last 3 lines of the specified log file.

Default: 10 lines.

--filter <String>

Specifies a text string to use as a filter for the log entries.

For example: --filter debug

Examples