Revision as of 18:23, June 5, 2017 by Mwest (talk | contribs) (Update with the copy of version: 8.5.2)
Jump to: navigation, search

Enabling Agents to View KPIs and Contact Center Statistics

You can configure Workspace Web Edition to display Key Performance Indicators (KPIs) and Contact Center Statistics in the Workspace Web Edition interface so that your agents can receive warnings and errors based on their statistics.

Important
KPIs and Statistics are reported only for the voice channel.

Web Services reports statistics based on the statistic names that you specify in the statistics.yaml file. You must configure the statistic names in the WS_Cluster application object by using Genesys Adminstrator (or Configuration Manager).

Important
The name of the statistic must correspond to the value of statistic-name in the statistics.yaml file.

statistics.yaml Setup

The statistics that are specified in the statistics.yaml file define which statistics and object types Web Services requests from Stat Server. A default statistics.yaml file is included with Web Services. It contains all of the statistics that Web Services needs internally as well as those that are required by the agent and supervisor applications.

The statistics.yaml file is located in the main Web Services config folder (this is defined by the config.path variable, which is set to /opt/jetty/genconfig by default on the ubuntu voice machine).

The following is an example entry in the statistics.yaml file which demonstrates how it maps to the section in configuration server. 

name: OutboundCalls
notificationFrequency: 10
notificationMode: PERIODICAL
objectType: AGENT
statisticDefinitionEx:
    category: TotalNumber
    dynamicTimeProfile: "0:00"
    intervalType: GrowingWindow
    mainMask: CallOutbound
    subject: DNAction

Click the link below to see an example of a statistics.yaml file:

[+] statistics.yaml

Statistics Reporting Setup

Web Services uses several statistics internally to support contact availability and also provides a default set of statistics that are displayed in the agent interface.

Web Services Node Configuration

The value of the nodeId property must be set in the server-settings.yaml file. The value of this option must be a unique identifier for each node in a Web Services cluster. All nodes that share the same Cassandra storage read the contact centers that require statistics and divide the monitoring tasks among the nodes.

Statistics Time-to-Live

You can define the time-to-live for statistic storage in server-settings.yaml file by using the statisticsTTL property. If this optional parameter is not defined, the default value of 86400 (24 hours) is used. This property defines the interval of time for which the value of the statistics are stored.

Configuring KPIs and Statistics for Workspace Web Edition

To display statistics (KPIs) in the My Statistics tab of the Workspace Web Edition interface, you must specify at least one statistic in the kpi.displayed-kpis option.

  • The kpi.displayed-kpis option is configured in the interaction-workspace section in the WS_Cluster application.
  • The value of this option is a coma-separated list of section names defined in the WS_Cluster application. Each section has an option named statistic-name that corresponds to a statistic that is defined in the statistics.yaml file and depends on what is supported by your Stat Server application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface.

To display contact center statistics in the Contact Center Statistics tab of the Workspace Web Edition interface, you must specify at least one statistic in the statistics.displayed-statistics option.

  • The statistics.displayed-statistics option is configured in the interaction-workspace section in the WS_Cluster application.
  • The value of this option is a coma-separated list of section names defined in the WS_Cluster application. Each section has an option named statistic-name that corresponds to a statistic that is defined in the statistics.yaml file, and depends on what is supported by your Stat Server application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface.
Important
The statistics and KPIs that are in the statistics.yaml file are the only statistics and KPIs that are currently supported by Workspace. Genesys recommends that you do not modify the statistics.yaml file.

The following attributes are available for each statistic that you specify in the related section:

  • measurement-unit — an optional display value
  • statistic-name — the name of the statistic to be displayed. This must correspond to the value of the name attribute in the statistics.yaml file.
  • statistic-type — (optional) the type of statistic, either numeric or duration (in HH:MM:SS format). If the attribute isn't specified, numeric is used unless the statistic name ends with "Duration".
  • warning-level-high — (optional) the maximum value of the statistic before a warning is raised. No warnings below this value.
  • warning-level-low — (optional) the minimum value of the statistic before a warning is raised. No warnings above this value.
  • error-level-high — (optional) the maximum value of the statistic before an error is raised. No errors below this value.
  • error-level-low — (optional) the minimum value of the statistic before an error is raised. No errors above this value.
  • worst-value-high — (optional) the maximum value of the statistic before a critical error is raised.
  • worst-value-low — (optional) the minimum value of the statistic before a critical error is raised.

The following is an example of a KPI section called KPI-OutboundCalls that you can define for the OutboundCalls statistic in the WS_Cluster options by using Configuration Manager: 

[KPI-OutboundCalls]
description=Total number outbound calls
statistic-name=OutboundCalls
warning-level-low=4

To display this KPI in the My Statistics tab, set the value of the kpi.displayed-kpis option to KPI-OutboundCalls.

The following is an example of a Contact Center Statistic section called CC-AverageWaitingTime that you can define for the AverageWaitingTime statistic in the WS_Cluster options by using Configuration Manager: 

[CC-AverageWaitingTime]
statistic-name=AverageWaitingTime

To display this statistic in the Contact Center Statistics tab, set the value of the statistics.displayed-statistics option to CC-AverageWaitingTime.

The following is an example of a configuration (.cfg) file that is related to a statistics configuration for the options in a WS_Cluster object that is exported from Configuration Manager:

[+] statistics-kpi.cfg

Stat Server Configuration

Any Stat Server application in a Genesys environment to which the Web Services node/cluster will connect must include a set of statistic definitions that match those that are specified in the statistics.yaml file.

Comments or questions about this documentation? Contact us for support!