Daily Reports Tab

The Daily Report feature collects, analyzes, and reports the most significant issues of the fabric in the last 24 hours (from 00:00 to 24:00). The reports present statistical information such as Summary of Traffic, Congestions and UFM events that occurred during the last 24 hours. These statistics are sent to a pre-defined recipients list on a daily basis. It is also possible to specify a non-24-hour range, by updating the UFM configuration file—see section ‎Other Daily Report Configurations for details.

The following are the formats of the Daily Report:

• Interactive—opened via the browser. The charts are displayed in SVG format. This format can be accessed from the UFM Web UI and is also sent by email as an attachment (see Daily Report View in the Web UI section below).

• Static—opened via mail client (Outlook, Gmail, Hotmail, etc). The charts are displayed in PNG format.

Daily Report can be activated/deactivated via the /opt/ufm/conf/gv.cfg file.

To deactivate the Daily Report, do the following:

1. Open the /opt/ufm/conf/gv.cfg file.

2. Find the DailyReport section.

3. Set the daily_report_enabled option to false.

            

            
daily_report_enabled = false
        

To re-activate the Daily Report:, do the following:

1. Open the /opt/ufm/conf/gv.cfg file.

2. Find the DailyReport section.

3. Set the daily_report_enabled option to true.

            

            
daily_report_enabled = true
        

UFM saves the interactive Daily Reports under the /opt/ufm/files/reports/Daily directory. Each report will be saved under a directory with its respective date. For example, report for Sept. 28th, 2014 will be located under: /opt/ufm/files/reports/Daily/2014-09-28/By default, the maximum number of reports that will be saved is 365 (one per day).

To configure the maximum number of reports to save, do the following:

1. Open the /opt/ufm/conf/gv.cfg file.

2. Find the DailyReport section.

3. Set the max_reports option to the desired value. A count of 0 (zero) means no copies are retained. (default and max is 365).

4. Restart UFM.

All the Daily Report configuration parameters can be found in the "DailyReport" section in gv.cfg configuration file.

The following are additional Daily Report configurations options:

• top_x option specifies the number of results in the "Top X" charts. Max number can be 20. (Default value is 10). top_x value will be applied to all charts existing in the Daily Report.

• mail_send_interval option specifies the epoch in minutes after midnight that the report can be emailed. By default, if UFM was down during midnight, and was restarted after 1:00, the report of the previous day will be generated and saved, but will not be emailed. This can be changed by editing the mail_send_interval. (default value is 60 minutes, meaning that the report will be send only between 00:00 to 1:00).

• log_level option specifies the Daily Report log verbosity. Default value is INFO (optional values: INFO, WARNING and ERROR).

• attach_fabric_health_report option indicates whether or not to add the fabric health report as attachment to the mail. Default value is true (optional values: true or false).

• fabric_health_report_timeout specifies the max time in seconds, to wait for fabric health report generation. Default value is 900 seconds (15 minutes).
  In case of large fabrics, fabric health report might take longer than the default 15 minutes. User can enlarge the timeout for fabric health report to complete.

• max_attached_file_size specifies the maximum file size in Bytes for each email attachment that can be sent. Default value is 2 Megabytes.

  If the size of a certain file has exceeded this value, the file will not be sent as an attachment in the Daily Report mail.

  Copy

  Copied!

              
  
              
  [DailyReport]
  # top_x specifies the number of results per each top x chart.
  # max number can be 20.(default is 10)
  top_x=10
  # max_reports specifies the number of reports to save.
  # A count of 0 (zero) means no copies are retained.(default and max is 365)
  max_reports = 365
  #time interval in minutes after midnight
  #when passed mail will not be sent
  mail_send_interval=60
  log_level = INFO
  daily_report_enabled = true
  attach_fabric_health_report = true
  fabric_health_report_timeout = 900
  # max attached file size in bytes, default is 2M (2097152 Bytes)
  max_attached_file_size = 2097152
          

• max_attached_file_size specifies the maximum file size in Bytes for each email attachment that can be sent. Default value is 2 Megabytes.

• The start_hour and end_hour options enable selecting a sub-range of the day, during which, the relevant report data will be collected. Since by default this option is configured to collect data from the last 24 hours, the default start_hour is set to 0 (or 00), and the default end_hour is set to 24.

If these options are configured to different values, the generated report will include data from the specified interval only. The start_hour values range is 00 to 23, and the end_hour values range is 00 to 24. The specified end_hour must be greater than the specified start_hour. If, for example, the start_hour is configured to 08, and the end_hour is configured to 10, the generated report will include data collected between 08:00-10:00 (excluding 10:00).

Sidebar

The Sidebar includes general information regarding the fabric, such as: the site name, number of switches and hosts in the fabric, and the dates on which the report was generated.

Navigation between the charts can be done via the menu charts on the sidebar.

Daily Report Highlights

The top of the report shows highlight activities of the network, such as: the host with the most events, the most congested host and switch, and top sender host. To see the related chart of each highlight, click the corresponding

icon in the "Link to chart column.

Available Charts

Events by Severity

Events by Severity displays in a graphical view the distribution of all the UFM events that occurred during each hour. Events are separated into the following severity levels: Critical, Minor, and Warning.

Normalized Traffic and Congestion

Normalized Traffic and Congestion displays in a graphical view the normalized traffic and congestions of the fabric. This graph displays the accumulated data for the Senders in the fabric (not including switches).

Congestion normalization is based on the number of delayed packets (packets that wait in the queue) and bandwidth loss.

The graph displays the percentage of the traffic utilization in green and the percentage of the congestion in red.

Hosts Utilization Distribution

Hosts Utilization Distribution displays in a graphical view the groups of hosts, where each host belongs to a specific group according to its utilization status.

To see the hosts in each group, click on the pie chart (at the interactive report).

The utilization groups are:

• Very low—up to 20% utilized

• Low—20–40% utilized

• Moderate—40–60% utilized

• High—60–80% utilized

• Very high—80–100% utilized

Most Active Events

Most Active Events displays in a graphical view the most active events, ordered by the number of occurrences during the last 24 hours.

Top Senders

Top Senders displays in a graphical view the normalized traffic and congestions of the top sender hosts. Congestion normalization is based on the number of the delayed packets (packets that wait in queue) and bandwidth loss.

The graph displays the percentage of the traffic utilization in green and the percentage of the congestion in red.

Hosts with Most Events

Hosts with Most Events displays in a graphical view the hosts with the most events. Events are separated into the following severity levels: Critical, Minor, and Warning.

Hosts with Most Critical Events

Hosts with Most Critical Events displays in a graphical view the hosts with the most critical events.

Most Congested Hosts

Most Congested Hosts displays in a graphical view the normalized congestions of the most congested hosts. Congestion normalization is based on the number of the delayed packets (packets that wait in queue) and bandwidth loss.

Hosts with Most Link Down Events

Hosts with Most Link Down Events displays in a graphical view the list of the hosts with the most link down events during the last 24 hours.

Switches with Most Events

Switches with Most Events displays in a graphical view the switches with the most events. Events are separated into the following severity levels: Critical, Minor, and Warning.

Switches with Most Critical Events

Switches with Most Critical Events displays in a graphical view the switches with the most critical events.

Most Congested Switches

Most Congested Switches displays in a graphical view the normalized congestions of the most congested switches. Congestion normalization is based on the number of delayed packets (packets that wait in queue) and bandwidth loss.

Switches with Most Link Down Events

Switches with Most Link Down Events displays in a graphical view the list of the switches with the most link down events during the last 24 hours.

Warning

Clicking on the “help” icon

in the upper right corner of each chart, in the interactive report , will display a short description of the chart.

Clicking on the “home” icon

in the upper right corner of each chart, in the interactive report , will move the display to the beginning of the report.

Daily Report View in the Web UI

In this tab, you can select the UFM daily reports that you wish to view and you can specify the recipients to which these daily reports will be sent.

To view a specific daily report, click the relevant report date from the list of available daily reports.

To configure the Recipients list for the daily reports, do the following:

1. Click Recipients List under System Health → Daily Reports tab.

   

2. Click New.

   

3. In the Recipients List window, enter valid recipient email addresses, comma-separated, and click Submit.

   

   The new recipient/recipients will be added to the Daily Reports Recipients list.
   

   

   These recipients will automatically start receiving the UFM daily reports.