Documentation Center
AlienVault® USM Anywhere™

NGINX

When you configure NGINX integration to send log data to USM Anywhere, you can use the NGINX plugin to translate the raw log data into normalized events for analysis.

Device Details
Device vendor NGINX
Device type Web server
Connection type syslog
Vendor link https://www.nginx.com/resources/admin-guide/logging-and-monitoring/

Integrating NGINX

Before you configure the integration, you must have the IP Address of the USM AnywhereUSM Appliance Sensor.

To configure NGINX to send log data over syslog to USM Anywhere

  1. Open /etc/nginx/nginx.conf.

  2. Edit the logging directives error_log and access_log, as shown:

    error_log syslog:server=<USM_Anywhere_IP>:514,tag=nginx debug

    access_log syslog:server=<USM_Anywhere_IP>:514,tag=nginx,severity=info

    Where:

    severity can equal any of the following values, in increasing severity:

    • debug
    • info
    • notice
    • warn
    • error (default)
    • crit
    • alert
    • emerg

    Messages are logged at the selected level and all levels above that, if any.

Plugin Enablement

The Nginx plugin automatically processes all messages that have the syslog tag nginx.

Available Plugin Fields

The following plugin fields are important attributes extracted from the syslog message. USM Anywhere reports use these fields, and you can also reference them when creating custom reports. In addition to reporting, the USM Anywhere correlation rules make use of these fields.

  • timestamp_occured

  • bytes_out

  • response_code

  • request_url

  • time_zone

  • request_method

  • application_protocol

  • source_address

  • event_name

  • event_description

  • request_referrer

  • request_user_agent

Troubleshooting

For troubleshooting, refer to the vendor documentation:

https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/