perfSONAR User Q&A and Other Discussion

[Andrew Lake <>]

Hi George,

The “name” section of the notifications controls the subject. Also under the “parameters” sections there is a subject prefix you can use to add a different tag. Here is an example of a notification we have on ESnet that subject “[MaDDash] ESnet Performance Problems”.

- name: "ESnet Performance Problems"

     type: "email"

     schedule: "0 * * * ?"

     problemReportFrequency: 86400

     minimumSeverity: 1

     filters:

        - type: "category"

          value: "PERFORMANCE"

     parameters:

       dashboardUrl: "http://ps-dashboard.es.net"

       subjectPrefix: "[MaDDash]"

       from: "..."

       to:

           - "..."

Hope that helps,

Andy

On May 2, 2017 at 4:00:37 PM, Uhl, George D. (GSFC-423.0)[SGT INC] () wrote:

Thanks Andrew, that was very helpful.

Just to make sure I understand what you wrote:

Multiple filters of the same type are treated as OR conditions.

Multiple filters of different types are teated as AND conditions.

I can specify the email subject line in the Notification name field.  Is there a way to change the embedded title of the email from “MaDDash: Test Email Report” to something else?  I put in a title field in the notification section of my yaml hoping that would override it but that didn’t work.

-George

From: Andrew Lake <>
Date: Tuesday, May 2, 2017 at 9:32 AM
To: George Uhl <>, perfsonar-user <>
Subject: Re: [perfsonar-user] Maddash notification documentation

Hi George,

Not yet, I am working on it. Was hoping to have that out by now but have been distracted by other things. There are currently four types of filters you can add in the notification block:

1. category - This can be PERFORMANCE or CONFIGURATION. PERFORMANCE matches on patterns that contain “red" or “yellow” (i.e. checks that find data but fall below your set thresholds). CONFIGURATION matches against “orange (i.e. when the dashboard can't find data for a given test)

2. “dashboard” - These correspond the names in the “dashboards” section of your maddash.yaml file. They essentially on alert on problems found in the grids that belong to a dashboard.

3. “grid” - These correspond to the names of individual grids found in the “grids” section of the maddash.yaml file

4. “site”- This is the name of a row or column. Usually the hostname or IP of the host being checked.

You can use multiple filters. Multiple filters of the same type are treated as an OR condition. For example if you define two “site” filters, one for "host1” and another for “host2”, you will get any alert that includes host1 or host2. Multiple filers of the same type are treated as an AND condition. If we were to add a “category” filter with a value of “PERFORMANCE” to the previous example it would send alerts that are of type performance and include either host 1 or host 2. Hope some of that is helpful. 

Thanks,

Andy

On May 1, 2017 at 10:55:11 AM, Uhl, George D. (GSFC-423.0)[SGT INC] () wrote:

Hi,

Is there a comprehensive guide to the maddash notification system.  I’m interested in the available filtering options for email notifications.

Thanks,

George