Citrix NetScaler ADC Syslog Integration Guide

Citrix Configuration

Access the NetScaler administration interface using your web browser and log in using your administrator credentials.

Add a Syslog Server

Go to the Configuration tab and follow the path System > Auditing in the left-hand menu. Go to the Servers tab and click the Add button. Enter the IP address of the syslog server and the port number it uses.(UDP 514)
In Facility, specify the category of the logs (for example, local0 or local7).
Select the log level in Log Level. You can select ALL to send all logs or select specific levels such as INFO, WARNING, ERROR.
Save the settings.

Defining Syslog Actions

Go to Configuration > System > Auditing and go to the Policies tab and click the Add button. In the Name field, give this policy a name and in the Action field, select the syslog server you created earlier. In the Expression field, you can set specific filters or conditions for triggering logs, but in general you can leave this field default.
Save the settings.

Policy Binding:

After creating a Syslog policy, you need to bind this policy to the system. Go to Configuration > System > Auditing > Bindings tab and assign a policy to Global or a specific object (for example an IP address). Select the syslog policy you created earlier and perform the assignment.
Save the settings.

Log forwarding should be done in standard syslog format.

Log Format Sample

<Date and Time> <Server Name> <Session Info> : <Module> <Message Code> <Additional Info> : "<Description or Reason>"

A time zone after the date and time is optional. It can be an abbreviation such as GMT or UTC, or an offset such as +0300. The server name is written to EventSource.HostName and can contain letters, digits, underscores, hyphens and dots. If the header has no time zone and the server name is only three to five uppercase letters (for example NSCT), Logsign reads the name as the time zone and EventSource.HostName stays empty.

REWRITE Message Fields

The body of a REWRITE Message log is the message expression you define in your NetScaler rewrite policy, so Logsign extracts fields only from the two formats below. The first format is a tag followed by key=value pairs:

27/10/2026:17:27:46 ns_vpx01 0-PPE-3 : default REWRITE Message 402604 0 : "AI_BOT_UA src=198.51.100.20 host=www.example.com ua=Mozilla/5.0 (KHTML, like Gecko) path=/x"

Item in the bodyLogsign field
Tag at the start (AI_BOT_UA in the sample)Event.Type
srcSource.IP
dstDestination.IP
hostURL.Domain
uaSource.UserAgent
pathURL.Path

The tag must come first and cannot contain spaces or an equals sign. Keys are lowercase and at least one key from the table must be present. Any other key is ignored, and the body is not copied to Event.Note. A value can contain spaces, but a space followed by a word and an equals sign starts a new key, so a value such as ua=Example foo=bar is cut at foo.

The second format is six comma-separated values in this order: source IP (Source.IP), action (Event.Action), type (Event.Type), destination IP (Destination.IP), domain (URL.Domain) and path (URL.Path).

A body that matches neither format is kept as it is in Event.Note.

Add Device

To make Citrix NetScaler ADC integration, it will be enough to know the ip address that the product has. When you fill in and save the necessary steps from the source addition screen with Syslog(514), the integration of your product will be completed and log flow will start. Whichever facility is selected in the log routing phase should be selected when adding the source.

Ekran Resmi 2024-11-04 09.12.15.png

Just fill in the ip section, specify the facility and the name you want to give to the resource.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
Become a Certified Logsign User/Administrator
Sign-up for Logsign Academy and take the courses to learn about Logsign USO Platform in detail. Enjoy the courses, and get your badges and certificates. In these courses, you'll learn how to use Logsign in your work and add value to your career.
Visit Our Blog
Our Logsign USO Platform illustrate our expertise. So do the blog. Through our blog posts, deepen your knowledge on various SecOps topics or get updated about important news & modern approaches for cybersecurity. Get into the habit of reading valuable information provided by Logsign. Be a step ahead.