Citrix Systems CITRIX NETSCALER 9.3 manual Configuring Snmp Alarms for Rate Limiting

Page 59

Citrix NetScaler Administration Guide

2.In the details pane, click Add.

3.In the Create SNMP Community dialog box, specify values for the following parameters, which correspond to parameters described in "Parameters for configuring an SNMP community string" as shown:

Community String*—communityName

Permission*—permissions *A required parameter

4.Click Create, and then click Close.

A message appears in the status bar, stating that the SNMP community string has been configured successfully.

To remove an SNMP community string by using the configuration utility

1.In the navigation pane, expand System, click SNMP, and then click Community.

2.In the details pane, select the community that you want to remove (for example, Com_All), and then click Remove.

Configuring SNMP Alarms for Rate Limiting

Citrix® NetScaler® appliances such as the NetScaler MPX 10500, 12500, and 15500 are rate limited. The maximum throughput (Mbps) and packets per second (PPS) are determined by the license purchased for the appliance. For rate-limited platforms, you can configure SNMP traps to send notifications when throughput and PPS approach their limits and when they return to normal.

Throughput and PPS are monitored every seven seconds. You can configure traps with high-threshold and normal-threshold values, which are expressed as a percentage of the licensed limits. The appliance then generates a trap when throughput or PPS exceeds the high threshold, and a second trap when the monitored parameter falls to the normal threshold. In addition to sending the traps to the configured destination device, the NetScaler logs the events associated with the traps in the /var/log/ ns.log file as EVENT ALERTSTARTED and EVENT ALERTENDED.

Exceeding the throughput limit can result in packet loss. You can configure SNMP alarms to report packet loss.

For more information about SNMP alarms and traps, see Configuring the NetScaler to Generate SNMPv1 and SNMPv2 Traps on page 48.

Configuring an SNMP Alarm for Throughput or PPS

To monitor both throughput and PPS, you must configure separate alarms.

59

Image 59
Contents Citrix NetScaler Administration Guide Copyright and Trademark Notice Page Page Contents Snmp Vii Audit Logging Web Server Logging 105 Advanced Configurations Contents Web Interface AppFlow Reporting Tool Contents Xvi Formatting Conventions Meaning Boldface Formatting Conventions for NetScaler DocumentationThis Preface To view the documentation Documentation Available on the NetScaler ApplianceConvention To provide feedback at the Knowledge Center home Getting Service and SupportNetScaler Documentation Feedback Preface Topics Authentication and AuthorizationShow system user Example Configuring Users and GroupsConfiguring User Accounts UserName User Name Parameters for configuring a user accountPassword Password Timeout CLI Idle Session Timeout SecsShow system group Example Configuring User GroupsTo create a user group by using the NetScaler command line Show system group groupName Example UserName Parameters for configuring a user groupShow system group groupName GroupName Group NameCLI Prompt CLI Idle Session Timeout Secs Configuring Command PoliciesBuilt-in Command Policies Runningconfig, and sh gslb Creating Custom Command PoliciesBuilt-in Command Policies Policy name Allows Except show runningconfig, showCommand specification regular expression Matches these commandsAction Parameters for configuring a command policySh system cmdPolicy Example PolicynameBinding Command Policies to Users and Groups Priority Parameters for binding a command policy to a userSh system user userName Example Sh system user userNameGroupName Parameters for binding a command policy to a groupSh system group groupName Example Sh system group groupNameTo reset the nsroot password Resetting the Default Administrator nsroot PasswordFsck /dev/ad0s1a Mount /dev/ad0s1a /flash Example of a User ScenarioSample Values for Creating Entities Field Configuration stepsConfiguring External User Authentication Configuring Ldap Authentication Bind DN Examples of Base Distinguished Name Ldap server Base DNExamples of Bind Distinguished Name Ldap server Authentication Type, select LDAP. Next to Server, click New Determining attributes in the Ldap directory Authentication Type, select Radius Configuring Radius AuthenticationChoosing Radius authentication protocols Configuring IP address extraction Authentication Type, select Tacacs Configuring TACACS+ AuthenticationConfiguring NT4 Authentication Authentication Type, select NT4 Authentication and Authorization Snmp Importing MIB Files to the Snmp Manager and Trap Listener Enable snmp alarm alarm name Sh snmp alarm alarm name Enabling or Disabling an Snmp AlarmSeverity Configuring AlarmsTo configure an Snmp alarm by using the command line Parameters for configuring Snmp alarmsTo add an Snmp trap by using the NetScaler command line Configuring TrapsTo configure Snmp alarms by using the configuration utility To configure Snmp Traps by using the configuration utility Parameters for configuring Snmp trapsEnabling Unconditional Snmp Trap Logging SnmpTrapLogging Snmp Trap Logging Configuring the NetScaler for Snmp v1 and v2 QueriesSpecifying an Snmp Manager Parameters for unconditional Snmp trap loggingShow snmp manager To add an Snmp manager by using the NetScaler command lineIPAddress Parameters for configuring an Snmp managerTo add an Snmp manager by using the configuration utility Permissions Parameters for configuring an Snmp community stringSpecifying an Snmp Community Sh snmp communityCommunity String*-communityName Configuring Snmp Alarms for Rate LimitingConfiguring an Snmp Alarm for Throughput or PPS Show snmp alarm PF-RL-RATE-THRESHOLD State Show snmp alarm PF-RL-PPS-THRESHOLDThresholdValue NormalValueAlarm Threshold-thresholdValue Normal Threshold-normalValue Configuring Snmp Alarm for Dropped PacketsParameters for configuring an Snmp alarm for dropped packets Configuring the NetScaler for SNMPv3 QueriesSetting the Engine ID To set the engine ID by using configuration utility Configuring a ViewTo set the engine ID by using the NetScaler command line Parameters for setting the engine IDTo add an Snmp group by using the NetScaler command line Configuring a GroupParameters for configuring an Snmp view SecurityLevel Configuring a UserParameters for configuring an Snmp group To configure a user by using the NetScaler command lineParameters for configuring an Snmp user Citrix NetScaler Administration Guide Snmp Audit Logging Audit Logging Show audit syslogAction name Configuring the NetScaler Appliance for Audit LoggingConfiguring Audit Servers ServerPort Parameters for configuring auditing serversShow audit nslogAction name ServerIPLog levels defined To configure a Syslog policy by using the command line Configuring Audit PoliciesTo configure an auditing server action Rule To configure an Nslog policy by using the command lineParameters for configuring audit policies Name* name Server* action To configure an audit server policyBinding the Audit Policies Globally Parameters for binding the audit policies globallyPre Requisites Configuring Policy-Based LoggingConfiguring an Audit Message Action To globally bind the audit policyLogtoNewnslog BypassSafetyCheckStringBuilderExpr Binding Audit Message Action to a Policy Installing and Configuring the Nslog ServerSoftware requirements Installing Nslog Server on the Linux Operating SystemSupported Platforms for the Nslog Server Operating system Installing Nslog Server on the FreeBSD Operating System Pkgdelete NSaudserver Pkginfo grep NSaudserverOn the system, where you have downloaded the Nslog package To install Nslog server on a Windows operating systemAudserver -stop Nslog Server Command OptionsTo uninstall the Nslog server on a Windows operating system Audserver -removeAudserver -remove Specifies To add the IP addresses of the NetScaler applianceTo start audit server logging Verifying the Nslog Server Configuration FileRunning the Nslog Server To create a filter Customizing Logging on the Nslog ServerCreating Filters Specifying Log Properties Default Settings for the Log Properties Following is a sample configuration file Sample Configuration File audit.confWeb Server Logging Enabling or Disabling Web Server Logging Configuring the NetScaler Appliance for Web Server LoggingBuffer Size Modifying the Default Buffer SizeParameter for modifying the buffer size Sh weblogparam ExampleSupported Platforms for the Nswl Client Operating system To modify the buffer size by using the configuration utilityCp pathtocd/Utilities/weblog/Solaris/NSweblog.tar /tmp Installing Nswl Client on a Solaris Operating SystemHardware requirements Pkginfo grep NSweblog Installing Nswl Client on a Linux Operating SystemCd /tmp Tar xvf NSweblog.tarTo get more information about the NSweblog RPM file Installing Nswl Client on a FreeBSD Operating SystemTo view the installed Web server logging files Cp pathtocd/Utilities/weblog/macos/NSweblog.tgz /tmp Installing Nswl Client on a Mac OS Operating SystemPkgdelete NSweblog To install the Nswl client on a Windows system Installing Nswl Client on a Windows Operating SystemRpm -i NSweblog.rpm Installing Nswl Client on an AIX Operating SystemTo uninstall the Nswl client on a Windows system Cp pathtocd/Utilities/weblog/AIX/NSweblog.rpm /tmpNswl Command Options Nswl command Specifies Nswl Client Command OptionsNswl -addns -f directorypath \log.conf Adding the IP Addresses of the NetScaler ApplianceTo add the Nsip address of the NetScaler appliance Customizing Logging on the Nswl Client System Verifying the Nswl Configuration FileTo verify the configuration in the Nswl configuration file Running the Nswl ClientOn OFF Parameters for Creating a Filter SpecifiesTo create a filter for a virtual server LogFormat Ncsa Ncsa Common Log Format Understanding the Ncsa and W3C Log FormatsNcsa Common Log Format Argument Specifies W3C Extended Log FormatDirective Descriptions EntriesDirectives Examples FieldsIdentifiers Prefix Descriptions SpecifiesDescription W3C Extended Log Format Identifiers No Prefix RequiredField Description Creating a Custom Log Format by Using the Nswl LibraryCreating a Custom Log Format Creating a Custom Log Format Manually To create the custom log format by using the Nswl LibraryCreating Apache Log Formats Sample Configuration FileNcsa 11.Custom Log Format Argument Specifies Arguments for Defining a Custom Log FormatFoobari Foobaro Formatt 12.Time Format Definition Argument Specifies Time Format DefinitionArgument Specifies 123 Web Server Logging 124 Advanced Configurations Show ntp server Example Configuring Clock SynchronizationTo add an NTP server by using the NetScaler command line Maxpoll Parameters for configuring an NTP serverServerName MinpollStarting or Stopping the NTP Daemon Configuring Clock Synchronization ManuallyEnable ntp sync Disable ntp sync Viewing the System Date and Time Usr/sbin/ntpd -c /nsconfig/ntp.conf -l /var/log/ntpd.logShow ns config Example Configuring TCP Window Scaling WSVal Parameters for configuring window scalingShow ns tcpParam Example Enabled Configuring Selective AcknowledgmentTo enable Sack by using the Configuration Utility Clearing the ConfigurationLevel Parameters for clearing a configurationTo clear a configuration by using the configuration utility Viewing the Http Band StatisticsRespBandSize ReqBandSizeBuilt-in Http Profiles Built-in profile Description Configuring Http ProfilesTo modify the band range by using the configuration utility To add an Http profile by using the NetScaler command lineParameters for adding an Http profile Built-in TCP Profiles Built-in profile Description Configuring TCP ProfilesTo add an Http profile by using the configuration utility To add a TCP profile by using the NetScaler command line Parameters for creating a TCP profile To add a TCP profile by using the configuration utility Specifying a TCP Buffer Size Example BufferSize Parameters for setting the TCP buffer size in a TCP profileMss Specifying the MSS Value in a TCP ProfileParameters for specifying the MSS value in a TCP profile Learn MSS for VServer LearnVsvrMSS Advanced Configurations 148 Web Interface Prerequisites How Web Interface WorksInstalling the Web Interface JRE tar file path Configuring the Web InterfaceWeb Interface tar file path Parameters for configuring Web interface sites Port Gateway Direct ModeAuthentication Point Access Gateway URLTransport Configuring a Web Interface Site for LAN Users Using HttpXML Service Addresses XML Service PortSite Type Published Resource Type Kiosk Mode A Web Interface Site Configured for LAN Users Using HttpVirtual Server Protocol select Https IP Address Port Add service WILoopbackService 127.0.0.1 Http A Web Interface Site Configured for LAN Users Using Https Configuring a Web Interface Site for LAN Users Using Https160 161 Add lb vserver Httpswi SSL 10.102.29.3 Configuring a Web Interface Site for Remote Users Using Agee A Web Interface Site Configured for Remote Users Using Agee 165 166 AppFlow NetScaler Flow Sequence How AppFlow WorksTemplates Flow RecordsConfiguring the AppFlow Feature Specifying a Collector Enabling or Disabling the AppFlow FeatureTo specify a collector by using the NetScaler command line Parameters for specifying a collector Configuring an AppFlow ActionTo remove a collector by using the NetScaler command line To specify a collector by using the configuration utilityComment Parameters for configuring an AppFlow actionCollectors Show appflow policy name Configuring an AppFlow PolicyRule Action Parameters for configuring an AppFlow policyHttp To add an expression by using the Add Expression dialog boxShow appflow global Binding an AppFlow PolicyLabelName Parameters for binding an AppFlow policyGotoPriorityExpression Invoke Invoke flag LabelTypeClick Apply Changes Enabling AppFlow for Virtual ServersSetting the AppFlow Parameters Enabling AppFlow for a ServiceAppFlow Parameters HttpHost HttpCookieHttpReferer HttpMethodReporting Tool Working with Reports Using the Reporting ToolTo invoke the Reporting tool Creating and Deleting Reports Using Built-in ReportsTime Intervals Time interval Displays Modifying the Time IntervalExporting and Importing Custom Reports Setting the Data Source and Time ZoneModifying a Chart Working with ChartsAdding a Chart To change the graph type of a chart Viewing a ChartTo view numeric data for a graph To change the color and graph type of a data set Examples Deleting a ChartTo export chart data to Excel Limits on Entity Numbers Retrieved by nscollect Entity name Stopping and Starting the Data Collection UtilityNetscaler/nscollect stop To stop nscollectTo start nscollect on the local system Entity name LimitNetscaler/nscollect start To start nscollect on the remote system