Configure log forwarders
You must configure a log recipient to receive log events, including:
- A logging server which can receive remote logging is configured and running.
- Connection information for the remote logging consumer. For example:
Parameter Example Fully qualified IP Address or DNS resolvable name of logger 192.168.1.1
TCP or UDP
Logger listen port
Appropriate port such as 5514.
Note that the port being used to communicate between Access Gateway and the logging server must be open.
Access Gateway will validate the logging server connection.
This example uses graylog. It is purely instructional. For configuration of systems designed to receive the logging input, see their appropriate documentation.
To create a log forwarder in Graylog:
- Sign in to the Graylog console as admin.
- Select System > Inputs.
- In the Select Input drop down search for Syslog UDP.
- Click Launch new input.
- In the Launch New Syslog UDP Input dialog enter the following:
Leave all other fields unchanged.
An appropriate title.
Enter an appropriate port.
Reminder, this port must be accessible from the Access Gateway AdminAn abbreviation of administrator. This is the individual(s) who have access to the Okta Administrator Dashboard. They control the provisioning and deprovisioning of end users, the assigning of apps, the resetting of passwords, and the overall end user experience. Only administrators have the Administration button on the upper right side of the My Applications page. instance.
Okta recommends selecting port 2048 or higher to avoid operating system restrictions.
- Click Save.
- Return to the Access Gateway administration UI console.
To add a remote logger:
- Navigate to your Access Gateway Instance.
- Select the Logs and Backups tab.
- Select the Log Forwarder pane .
- Select (+) > Syslog remote.
- In the Add Forwarder: Syslog pane enter the following.
The name of the forwarder.
See Feed Examples for details of each feed.
Select either UDP or TCP. Ensure this protocol matches the log listener.
Enter the DNS resolvable or IP address of the remote syslog listener.
Enter the port of the remote syslog listener.
- Click Validate Forwarder.
Access Gateway will then attempt to validate the remote logger connection information.
If required correct any input errors.
On success the Validate Forwarder button will become green and change to Forwarder Validated.
- Click Okay.
- The log forwarder definition will then appear in the list of log forwarders.
The syslog definition will briefly be shown as testing and then will move to valid on success.
To test log forwarding you must have:
- A configured log receiver. Follow the steps outlines in section Creating a Log Forwarder Receiver.
- A log forwarder defined in your Access Gateway node. Access loggers are simplest to test, as then generate events based on sign in to the Access Gateway Console.
- Be able to generate one or more events.
- Configure a system logger in your log server.
- Configure a log forwarder in Access Gateway, preferably an ACCESS logger.
- Ensure your system logger is started and ready to receive events
- Sign out and and then back into the Access Gateway Admin Console.
- Examine the log server. Multiple events should be generated resembling:
For examples of Log file formats see: Log Formats and Examples.