Versions Compared

Old Version 11

changes.mady.by.user Glen Steedman

Saved on

compared with

New Version Current

changes.mady.by.user Glen Steedman

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Note that the User key needs to be defined in matching groups

...

Configure policies

policies are a set of checks or parameters that are applied to Caches when they run.

...

This policy is applied to a NodeName discovery, this allows for allowing reports to be run on Nodes that have been removed from Yarngate (eg e.g. the interface) or if a node in a cluster is removed.

Defines the number of days before a Node is marked as Inactive , and when the Node is deleted. Below shows the Default

...

A custom policy can be added by Navigating to Administration > Caching > Policies > Create Policy.

Account age

...

A custom policy can be added by Navigating to Administration > Caching > Policies > Create Policy.

Audit Config

An Audit policy are is used with the Node Cache and System Audit Check report. Yarngate will collect via AXL/Soap/REST the audit configuration settings and check these against the policy to validate

CUCM

  • audit enabled

  • detailed audit enabled

  • correct audit level at least (6, informational)

  • being sent to one of the Syslog servers defined (the cucm audit config can only send to 1 syslog server)

Expressway

At least 1 of the 4 Syslog destination matches the following

  • audit level at least (informational)

  • being sent to one of the Syslog servers defined

  • Format set to IETF

  • port Number 601

  • Filter set

Unity

Not Supported at this time due to CSCwi88877, only syslog activity can be used

An Audit policy can be added by Navigating to Administration > Caching > Policies > Create Policy.

...

image-20240407-062019.pngImage Added

Configure Caches

Nodes

The Node Cache is used to speed speeds up reporting by not needing to continually poll the systems each time a report is run continually. The Node Cache is populated via entitlement group(s).

Policies are applied to the Node cache to check for Audit configuration settings , and age out deleted or unreachable Nodes as per the Policy.

A Schedule is recommended to be applied to keep the cache up-to-date , and to be run just before a maintenance windows end, window ends to allow the capture of any new nodes or removal.

Include syslog activity is optional, which will display a tally of the number of syslogs in the last 3 days from elastic search

Navigate to Administration > Caching > Caches > Create Cache

Apply the Node, Audit Policy and Entitlement group(s) and press save

...

...

Schedule

Once saved, navigate back to the new cache, and the Add a schedule Schedule button will be visible.

...

Add You can add the required details for the schedule with enable toggled at the bottom.

...

Navigate You can just navigate back to the cache to see the Schedule status of the Schedule.

...

To modify or disable the schedule, press modify, make the required changes and press save.

...

To Modify a schedule toggle, enable to Off with the required changes; once saved, once save toggle it to onOn. The scheduler wont won't allow a time from the past to be saved.

Subnet Groups

Subnet groups contain either Individual host hosts or Subnets, ; These are then linked to Subnet Group Lists.

...

Subnet Lists

Subnet List contain 1 contains one or more groups of Subnets, ; These are applied to robot accounts to validate that Robot accounts are being used from known hosts/systems.

...

Robot accounts are manually entered and assigned to a Subnet List. These will feed into the Robot report.

...

Note

Exception “Exception Report Log Log” not currently in use , will be removed from view. leave blank

...

Templates

Templates can be used to preform on going perform ongoing AdHoc reports with pre-filled details , or assigned to a Schedule to preform perform reoccurring reports.

Navigate to Administration > Reporting > Templates

Select the template type and populate the presets.

...

Select a Template followed by pressing and press Create Report From Template , to run an adhoc ad hoc report.

...

Info

Refer to Please take a look at the report types below for further more detailed information.

Schedules

Report templates are assigned to a Schedule to be run at regular intervals

  • Hourly

  • Daily

  • Weekly

  • Monthly

PRTG Sensor Push

Reports are created based on a Schedule with the option to send Element counters to winprtg

Robot Accounts

...

details to winprtg via an HTTP (s) Push.

Sensor Prefix specifies a name for each winprtg sensor, depending on the options of the 2 toggles.

Detailed Node Message text will include the Hostname of the Node with the issue in the alert text

Per Customer Sensor PRTG will suffix each customername as a sensor in to be sent to winprtg. If Detailed Node message text is selected each Customer sensor will list the nodes for that customer only.

See details in the Report for the toggle outputs

...

Currently, the Metrics pushed to winprtg include

Field

Value

sensorId

Text

prefix-status

prefix-customer

Text

Text

ScheduleName xyz Ran Ok <report>uuid</report><error>nodename</error<warn>nodename</warn>

ReportStatus

0 for normal

1 for warning flag

PassedElements

Numeric

PassedElements

Numeric

ErrorElements

Numeric

WarningElements

Numeric

SkippedElements

Numeric

TotalElements

Numeric

PassedElementsPct

Percent

ErrorElementsPct

Percent

WarningElementsPct

Percent

Robot Accounts

This report allows us to cross-check Robot accounts logging in from unknown IP addresses based on matching Defined subnets.

The report within the GUI will show logins from unknown (unmatched subnets) and the tally.

The xlsx contains all the Matched and Unmatched Subnets for the Robot accounts.

Due to the unstructured nature of the syslog messages, we need to exclude any activities from an enduser as well as some internal system actions; below are the default exclusions.

...

Info

It's possible to run a report for ALL users in the elastic search by leaving the Robot Accounts Cache Blank.

System Audit Check

This report uses the Node Cache to validate settings to confirm the Audit Policy complies with the expected values.

This is done on NodeCache data

the xlsx export contains all the configured details and the policy being tested against for CUCM, Expressway and Unity* and syslog tally if enabled.

Note: Unity only supports syslog tally at this time.

image-20240407-063520.pngImage Addedimage-20240407-063552.pngImage Added

Sample PRTG Rest Push

System Audit Check

Prefix is set to each sensor push. prefix-status is always sent for each type.

Yarngate will record the response from PRTG, which only gives back an error if the sensor doesn't match (eg not configured) This is recorded as Sucesss True/False

Setting Detailed Node Message Text to Off, Per Customer Sensor PRTG to Off

sensor prefix is sac00, only a single Push, with numeric data only .

Code Block
{"success":true,"data":{"sensorId":"sac00-status","inputs":{"Prtg":{"Text":"ScheduleName xyz00 Ran Ok <report>902aa63985d91e9a275c4965a7d73b36</report>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":8},{"Channel":"ErrorElements","Value":6},{"Channel":"WarningElements","Value":1},{"Channel":"SkippedElements","Value":4},{"Channel":"TotalElements","Value":19},{"Channel":"PassedElementsPct","Value":43,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":32,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":6,"Unit":"Percent"}]}}}}
Setting Detailed Node Message Text to On, Per Customer Sensor PRTG to Off

sensor prefix is sac01, only a single Push, with numeric data and all nodenames in text

Code Block
{"success":true,"data":{"sensorId":"sac10-status","inputs":{"Prtg":{"Text":"ScheduleName xyz10 Ran Ok <report>2b30510b4640128bec616f2cbcbc41fb</report><error>ucmc7-cuc ucmc7 ucmc6 ucmc5 labimp115-pub labcucm115-sub</error><warn>tm999cms01</warn>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":8},{"Channel":"ErrorElements","Value":6},{"Channel":"WarningElements","Value":1},{"Channel":"SkippedElements","Value":4},{"Channel":"TotalElements","Value":19},{"Channel":"PassedElementsPct","Value":43,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":32,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":6,"Unit":"Percent"}]}}}}
Setting Detailed Node Message Text to Off, Per Customer Sensor PRTG to On

sac-01 as the prefix, for each customer a seperate sensor push with numeric counters, followed by -status as the last

Code Block
{"success":true,"data":{"sensorId":"sac01-status","inputs":{"Prtg":{"Text":"ScheduleName xyz01 Ran Ok <report>902aa63985d91e9a275c4965a7d69290</report>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":8},{"Channel":"ErrorElements","Value":6},{"Channel":"WarningElements","Value":1},{"Channel":"SkippedElements","Value":4},{"Channel":"TotalElements","Value":19},{"Channel":"PassedElementsPct","Value":43,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":32,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":6,"Unit":"Percent"}]}}}}

Note success false for the 2nd element, indicating its not configured in PRTG

Code Block
{"success":false,"data":{"sensorId":"sac01-UCMC7-XLS-Master","inputs":{"Prtg":{"Text":"ScheduleName xyz01 Ran Ok <report>902aa63985d91e9a275c4965a7d69290</report>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":0},{"Channel":"ErrorElements","Value":2},{"Channel":"WarningElements","Value":0},{"Channel":"SkippedElements","Value":0},{"Channel":"TotalElements","Value":2},{"Channel":"PassedElementsPct","Value":0,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":100,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":0,"Unit":"Percent"}]}}}}
Setting Detailed Node Message Text to On, Per Customer Sensor PRTG to On

sac-11 as the prefix, for each customer a seperate sensor push with numeric and nodenames in text, followed by -status as the last

Code Block
{"success":true,"data":{"sensorId":"sac11-status","inputs":{"Prtg":{"Text":"ScheduleName xyz11 Ran Ok <report>UUID</report><error>ucmc7-cuc ucmc7 ucmc6 ucmc5 labimp115-pub labcucm115-sub</error><warn>tm999cms01</warn>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":8},{"Channel":"ErrorElements","Value":6},{"Channel":"WarningElements","Value":1},{"Channel":"SkippedElements","Value":4},{"Channel":"TotalElements","Value":19},{"Channel":"PassedElementsPct","Value":43,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":32,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":6,"Unit":"Percent"}]}}}}

suffix-customer , only the nodes that belong to the customer tm999-cust are populated to the text

Code Block
{"success":true,"data":{"sensorId":"sac11-tm999-cust","inputs":{"Prtg":{"Text":"ScheduleName xyz11 Ran Ok <report>UUID</report><error>labimp115-pub labcucm115-sub</error><warn>tm999cms01</warn>","Result":[{"Channel":"ReportStatus","Warning":0,"Value":0},{"Channel":"PassedElements","Value":5},{"Channel":"ErrorElements","Value":2},{"Channel":"WarningElements","Value":1},{"Channel":"SkippedElements","Value":1},{"Channel":"TotalElements","Value":9},{"Channel":"PassedElementsPct","Value":56,"Unit":"Percent"},{"Channel":"ErrorElementsPct","Value":23,"Unit":"Percent"},{"Channel":"WarningElementsPct","Value":12,"Unit":"Percent"}]}}}}