Jump to: navigation, search
(→‎Configuring KPIs and Statistics for Workspace Web Edition)
(Update with the copy of version: 8.5.2DRAFT)
Line 1: Line 1:
 
=Enabling Agents to View KPIs and Contact Center Statistics=
 
=Enabling Agents to View KPIs and Contact Center Statistics=
−
__NOTOC__
 
−
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.
 
  
−
<!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
+
The Workspace agent desktop includes two optional tabs that you can configure to display real-time agent [[EnablingAgentstoViewKPIs#KPIs|Key Performance Indicators (KPIs)]] ('''My Statistics''') and [[EnablingAgentstoViewKPIs#ContactCenterStatistics|contact center statistics]] ('''Contact Center Statistics'''). KPIs enable agents to focus on their efficiency and to compare their performance against that of their colleagues. Contact center statistics enable agents to focus on their efficiency and to compare their performance against that of their colleagues.
 +
 
 
{{NoteFormat|KPIs and Statistics are reported only for the voice channel.|1}}
 
{{NoteFormat|KPIs and Statistics are reported only for the voice channel.|1}}
  
−
Web Services reports statistics based on the statistic names that you specify in the <tt>statistics.yaml</tt> file. You must configure the statistic names in the <tt>WS_Cluster</tt> application object by using Genesys Adminstrator (or Configuration Manager).
+
To enable KPIs and statistics, you must first set up the <tt>statistic.yaml</tt>, which contains a list of statistics that can be requested from Stat Server. You then create sections in the Workspace Application object that correspond to the statistic names in the <tt>statistic.yaml</tt> file that you want to use. Finally, you configure the KPI and Contact Center Statistics options to display the statistics to your agents.
−
 
 
−
<!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
 
−
{{NoteFormat|The name of the statistic '''must''' correspond to the value of <tt>statistic-name</tt> in the <tt>statistics.yaml</tt> file. |1>}}
 
  
 
==statistics.yaml Setup==
 
==statistics.yaml Setup==
  
−
The statistics that are specified in the <tt>statistics.yaml</tt> file define which statistics and object types Web Services requests from Stat Server. A default <tt>statistics.yaml</tt> 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.
+
Workspace reports statistics based on the statistic names in the <tt>statistics.yaml</tt> file which is included with Web Applications and Services. The file contains all of the statistics that Workspace needs internally as well as those that are required by the agent and supervisor applications.
  
−
The <tt>statistics.yaml</tt> file is located in the main Web Services <tt>config</tt> folder (this is defined by the <tt>config.path</tt> variable, which is set to <tt>/opt/jetty/genconfig</tt> by default on the ubuntu voice machine).
+
The <tt>statistics.yaml</tt> file is located in the main Web Services <tt>config</tt> folder (this is defined by the <tt>config.path</tt> variable, which is set to <tt>/opt/jetty/genconfig</tt> by default on the Ubuntu voice machine).
  
−
The following is an example entry in the <tt>statistics.yaml</tt> file which demonstrates how it maps to the section in configuration server.
+
The following is an example entry in the <tt>statistics.yaml</tt> file. The name of the statistic is <tt>OutboundCalls</tt>. To use this statistic, create a section in the <tt>WS_Cluster</tt> application object by using Genesys Administrator (or Configuration Manager) such as <tt>KPI-OutboundCalls</tt>, then create an option in the section called <tt>statistic-name</tt> and assign <tt>OutboundCalls</tt> as the value. You can also create an option in the section called <tt>description</tt> and specify the value as <tt>Total number outbound calls</tt>.
  
 
<source lang="text" enclose="div">
 
<source lang="text" enclose="div">
Line 767: Line 763:
 
   subject: DNAction
 
   subject: DNAction
 
   maskType: MEDIA
 
   maskType: MEDIA
 +
 
</source>
 
</source>
 
</toggledisplay>
 
</toggledisplay>
−
 
−
==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====
 
====Web Services Node Configuration====
 
The value of the <tt>nodeId</tt> property must be set in the <tt>server-settings.yaml</tt> 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.
 
The value of the <tt>nodeId</tt> property must be set in the <tt>server-settings.yaml</tt> 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.
Line 779: Line 772:
 
You can define the time-to-live for statistic storage in <tt>server-settings.yaml</tt> file by using the <tt>statisticsTTL</tt> property. If this optional parameter is not defined, the default value of <tt>86400</tt> (24 hours) is used. This property defines the interval of time for which the value of the statistics are stored.
 
You can define the time-to-live for statistic storage in <tt>server-settings.yaml</tt> file by using the <tt>statisticsTTL</tt> property. If this optional parameter is not defined, the default value of <tt>86400</tt> (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==
+
{{AnchorDiv|KPIs}}
 +
==KPIs==
 +
To display statistics (KPIs) in the '''My Statistics''' tab of the Workspace interface, you must specify at least one statistic in the <tt>[[KPI#kpi.displayed-kpis|kpi.displayed-kpis]]</tt> option.
  
−
To display statistics (KPIs) in the '''My Statistics''' tab of the Workspace Web Edition interface, you must specify at least one statistic in the <tt>[[KPI#kpi.displayed-kpis|kpi.displayed-kpis]]</tt> option.
 
−
* The <tt>kpi.displayed-kpis</tt> option is configured in the <tt>interaction-workspace</tt> section in the <tt>WS_Cluster</tt> application.
 
−
* The value of this option is a coma-separated list of section names defined in the <tt>WS_Cluster</tt> application. Each section has an option named <tt>statistic-name</tt> that corresponds to a statistic that is defined in the <tt>statistics.yaml</tt> file and depends on what is supported by your [[Documentation/RTME|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 <tt>[[ContactCenterStatistics#statistics.displayed-statistics|statistics.displayed-statistics]]</tt> option.
 
−
* The <tt>statistics.displayed-statistics</tt> option is configured in the <tt>interaction-workspace</tt> section in the <tt>WS_Cluster</tt> application.
 
−
* The value of this option is a coma-separated list of section names defined in the <tt>WS_Cluster</tt> application. Each section has an option named <tt>statistic-name</tt> that corresponds to a statistic that is defined in the <tt>statistics.yaml</tt> file, and depends on what is supported by your [[Documentation/RTME|Stat Server]] application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface.
 
−
<!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
 
 
{{NoteFormat|The statistics and KPIs that are in the <tt>statistics.yaml</tt> file are the only statistics and KPIs that are currently supported by Workspace. Genesys recommends that you do not modify the <tt>statistics.yaml</tt> file.|1}}
 
{{NoteFormat|The statistics and KPIs that are in the <tt>statistics.yaml</tt> file are the only statistics and KPIs that are currently supported by Workspace. Genesys recommends that you do not modify the <tt>statistics.yaml</tt> file.|1}}
  
−
The following attributes are available for each statistic that you specify in the related section:
+
The following is an example of how to specify the <tt>InboundCalls</tt> statistic for display:
 +
<ol>
 +
<li>Choose a statistic from the <tt>statistics.yaml</tt> file that you want to display, such as <tt>InboundCalls</tt>.</li>
 +
<li>Create a section in the <tt>WS_Cluster</tt> application object by using Genesys Administrator (or Configuration Manager) such as <tt>KPI-InboundCalls</tt></li>
 +
<li>Create an option in the section called <tt>statistic-name</tt>.</li>
 +
<li>Assign <tt>InboundCalls</tt> as the value.</li>
 +
<li>(Optional) You can create other options in the section to specify a display name, such as <tt>description</tt> with the value as <tt>Total number inbound calls</tt>.
 +
<br>
 +
The attributes that you can specify include:
 +
<ul>
 +
<li>statistic-name(mandatory)</li>
 +
<li>target-value</li>
 +
<li>warning-level-low</li>
 +
<li>warning-level-high</li>
 +
<li>error-level-low</li>
 +
<li>error-level-high</li>
 +
<li>worst-value-low</li>
 +
<li>worst-value-high</li>
 +
<li>statistic-type &mdash; possible values are: duration, number. If statistic-type isn't specified, the default type is number excepted if the statistics name includes the duration keyword.</li>
 +
<li>measurement-unit &mdash; an optional display value.</li>
 +
</ul>
 +
Refer to [[EnablingAgentstoViewKPIs#SettingLevels|Setting the Warning, Error, and Worst Levels]] for more information about how to use the target, warning, error, and worst attributes.
 +
</li>
 +
<li>Repeat steps 1 through 5 for each statistic that you want to use.</li>
 +
<li>In the <tt>interaction-workspace</tt> section in the <tt>WS_Cluster</tt> application, specify the name of the section that you created in Step 2 as one of the values of the <tt>kpi.displayed-kpis</tt> option. The value of this option is a coma-separated list of section names defined in the <tt>WS_Cluster</tt> application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface. For example: <tt>KPI-InternalCalls,KPI-OutboundCalls,KPI-InboundCalls,KPI-CurrentTargetState,KPI-CurrNumberInCall</tt>
 +
[[File:WWE_852_Sample_KPI_Configuration.png|thumb|center|Example of the KPI-InboundCalls section]]
 +
</li>
 +
</ol>
  
−
* measurement-unit &mdash; an optional display value
+
{{AnchorDiv|ContactCenterStatistics}}
−
* statistic-name &mdash; the name of the statistic to be displayed. This must correspond to the value of the <tt>name</tt> attribute in the <tt>statistics.yaml</tt> file.
+
==Contact Center Statistics==
−
* statistic-type &mdash; (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".
+
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 <tt>[[ContactCenterStatistics#statistics.displayed-statistics|statistics.displayed-statistics]]</tt> option.
−
* warning-level-high &mdash; (optional) the maximum value of the statistic before a warning is raised. No warnings below this value.
 
−
* warning-level-low &mdash; (optional) the minimum value of the statistic before a warning is raised. No warnings above this value.
 
−
* error-level-high &mdash; (optional) the maximum value of the statistic before an error is raised. No errors below this value.
 
−
* error-level-low &mdash; (optional) the minimum value of the statistic before an error is raised. No errors above this value.
 
−
* worst-value-high &mdash; (optional) the maximum value of the statistic before a critical error is raised.
 
−
* worst-value-low &mdash; (optional) the minimum value of the statistic before a critical error is raised.
 
  
−
The following is an example of a KPI section called <tt>KPI-OutboundCalls</tt> that you can define for the <tt>OutboundCalls</tt> statistic in the <tt>WS_Cluster</tt> options by using Configuration Manager:
+
{{NoteFormat|The statistics and KPIs that are in the <tt>statistics.yaml</tt> file are the only statistics and KPIs that are currently supported by Workspace. Genesys recommends that you do not modify the <tt>statistics.yaml</tt> file.|1}}
−
 
−
[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 <tt>kpi.displayed-kpis</tt> option to <tt>KPI-OutboundCalls</tt>.
+
The following is an example of how to specify the <tt>AverageWaitingTime</tt> statistic for display:
 +
<ol>
 +
<li>Choose a statistic from the <tt>statistics.yaml</tt> file that you want to display, such as <tt>InboundCalls</tt>.</li>
 +
<li>Create a section in the <tt>WS_Cluster</tt> application object by using Genesys Administrator (or Configuration Manager) such as <tt>CC-AverageWaitingTime</tt></li>
 +
<li>Create an option in the section called <tt>statistic-name</tt>.</li>
 +
<li>Assign <tt>AverageWaitingTime</tt> as the value.</li>
 +
<li>(Optional) You can create other options in the section to specify a display name, such as <tt>description</tt> with the value as <tt>Average Customer Wait Time</tt>.
 +
<br>
 +
The attributes that you can specify include:
 +
<ul>
 +
<li>statistic-name(mandatory)</li>
 +
<li>target-value</li>
 +
<li>warning-level-low</li>
 +
<li>warning-level-high</li>
 +
<li>error-level-low</li>
 +
<li>error-level-high</li>
 +
<li>worst-value-low</li>
 +
<li>worst-value-high</li>
 +
<li>statistic-type &mdash; possible values are: duration, number. If statistic-type isn't specified, the default type is number excepted if the statistics name includes the duration keyword.</li>
 +
<li>measurement-unit &mdash; an optional display value.</li>
 +
</ul>
 +
Refer to [[EnablingAgentstoViewKPIs#SettingLevels|Setting the Warning, Error, and Worst Levels]] for more information about how to use the target, warning, error, and worst attributes.
 +
</li>
 +
<li>Repeat steps 1 through 5 for each statistic that you want to use.</li>
 +
<li>In the <tt>interaction-workspace</tt> section in the <tt>WS_Cluster</tt> application, specify the name of the section that you created in Step 2 as one of the values of the <tt>statistics.displayed-statistics</tt> option. The value of this option is a coma-separated list of section names defined in the <tt>WS_Cluster</tt> application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface. For example: <tt>CC-AverageWaitingTime,CC-Current_In_Queue,CC-CurrMaxCallWaitingTime,CC-ServiceLevel,CC-Total_Abandoned,CC-Total_Answered</tt>
 +
[[File:WWE_852_Sample_Statistics_Configuration.png|thumb|center|Example of the CC-AverageWaitingTime section]]
 +
</li>
 +
<li>Specify the queue group, agent group, routing point, and/or virtual queue for which you want statistics reported by using the following options:
 +
<ul>
 +
<li><tt>[[ContactCenterStatistics#statistics.queue-groups|statistics.queue-groups]]</tt></li>
 +
<li><tt>[[ContactCenterStatistics#statistics.agent-groups|statistics.agent-groups]]</tt></li>
 +
<li><tt>[[ContactCenterStatistics#statistics.routing-points|statistics.routing-points]]</tt></li>
 +
<li><tt>[[ContactCenterStatistics#statistics.virtual-queues|statistics.virtual-queues]]</tt></li>
 +
</ul>
 +
</li>
 +
<li>Specify the refresh time, in seconds, for the statistics in the '''Contact Center Statistics''' tab by using the <tt>[[ContactCenterStatistics#statistics.refresh-time|statistics.refresh-time]]</tt> option.</li>
 +
</ol>
 +
{{AnchorDiv|SettingLevels}}
 +
==Setting the Warning, Error, and Worst Levels==
 +
Workspace provides eight non-mandatory options that you can use to define low and/or high levels of warning and error and low and/or high levels of worst values.
  
−
The following is an example of a Contact Center Statistic section called <tt>CC-AverageWaitingTime</tt> that you can define for the <tt>AverageWaitingTime</tt> statistic in the <tt>WS_Cluster</tt> options by using Configuration Manager:
+
Some statistics are in an error state when they are below a certain value, while others are in an error state when they are above a certain value; for some statistics both a lower error threshold and a higher error threshold are required. The following non-mandatory options enable you to set a low and high threshold for a statistic:
 +
* <tt>error-level-low</tt>&mdash;Values below this value are in an error state for the statistic.
 +
* <tt>error-level-high</tt>&mdash;Values above this value are in an error state for the statistic.
  
−
[CC-AverageWaitingTime]
+
Some statistics are in a warning state when they are below a certain value, while others are in a warning state when they are above a certain value; for some statistics both a lower warning threshold and a higher warning threshold are required. The following non-mandatory options enable you to set a low and high threshold for a statistic:
−
statistic-name=AverageWaitingTime
+
* <tt>warning-level-low</tt>&mdash;Values below this value are in a warning state for the statistic.
 +
* <tt>warning-level-high</tt>&mdash;Values above this value are in a warning state for the statistic.
  
−
To display this statistic in the Contact Center Statistics tab, set the value of the <tt>statistics.displayed-statistics</tt> option to <tt>CC-AverageWaitingTime</tt>.
+
Use the error and warning options to specify ranges that are most suitable for the statistic.
  
−
The following is an example of a configuration (<tt>.cfg</tt>) file that is related to a statistics configuration for the options in a <tt>WS_Cluster</tt> object that is exported from Configuration Manager:
+
Some statistics are performance based. The agent's result is compared to a target value to determine the agent's level of performance. Some statistics require a lower worst value and some require a higher worst value. For some statistics, both a lower and a higher worst value are required.
 +
* <tt>worst-value-low</tt>&mdash;Values below this value result in a negative evaluation for the KPI.
 +
* <tt>worst-value-high</tt>&mdash;Values above this value result in a negative evaluation for the KPI.
 +
* <tt>target-value</tt>&mdash;The target value to be reached by the agent.
 +
* <tt>evaluation-display</tt>&mdash;Specifies which value is displayed to the agent, a performance indicator or the raw statistic in the format of the statistic (for example, number, date, or percentage). If the option is set to <tt>Result</tt>, the actual statistic value is displayed. If the option is set to <tt>Evaluation</tt>, the performance of the agent is calculated by using the following formulae:
 +
If the statistic value is lower than the target value, the following evaluation is applied:
 +
Agent Performance = (Agent Result - <tt>worst-value-low</tt>) / (Target Value -<tt>worst-value-low</tt>) x 100
 +
or:
 +
If the statistic value is higher than the target value, the following evaluation is applied:
 +
Agent Performance = (<tt>worst-value-high</tt> - Agent Result) / (<tt>worst-value-high</tt> - Target Value) x 100
 +
==Example of a Statistics Configuration file for Workspace==
 +
The following is an example of a configuration (<tt>.cfg</tt>) file that is related to a statistics configuration for the options in a <tt>WS_Cluster</tt> object that was exported from Configuration Manager:
  
 
<toggledisplay showtext="[+] statistics-kpi.cfg" hidetext="[-] statistics-kpi.cfg">
 
<toggledisplay showtext="[+] statistics-kpi.cfg" hidetext="[-] statistics-kpi.cfg">
Line 874: Line 931:
 
</toggledisplay>
 
</toggledisplay>
  
−
====Stat Server Configuration====
+
===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 <tt>statistics.yaml</tt> file.
 
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 <tt>statistics.yaml</tt> file.
  
−
* Only [[Documentation:HTCC:API:Listofstatisticstobemonitored:8.5.1#Agent_Statistics|Agent Statistics]] and [[Documentation:HTCC:API:Listofstatisticstobemonitored:8.5.1#Skills_Statistics|Skills Statistics]] should be specified for KPIs.
+
* Only [[Documentation:HTCC:API:Listofstatisticstobemonitored:8.5.1#Agent_Statistics|Agent Statistics]] should be specified for KPIs.
 
* Only [[Documentation:HTCC:API:Listofstatisticstobemonitored:8.5.1#Queue_Statistics|Queue Statistics]] should be specified for Contact Center Statistics.
 
* Only [[Documentation:HTCC:API:Listofstatisticstobemonitored:8.5.1#Queue_Statistics|Queue Statistics]] should be specified for Contact Center Statistics.
  
 
[[Category:V:HTCC:8.5.2]]
 
[[Category:V:HTCC:8.5.2]]

Revision as of 12:48, June 9, 2017

Enabling Agents to View KPIs and Contact Center Statistics

The Workspace agent desktop includes two optional tabs that you can configure to display real-time agent Key Performance Indicators (KPIs) (My Statistics) and contact center statistics (Contact Center Statistics). KPIs enable agents to focus on their efficiency and to compare their performance against that of their colleagues. Contact center statistics enable agents to focus on their efficiency and to compare their performance against that of their colleagues.

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

To enable KPIs and statistics, you must first set up the statistic.yaml, which contains a list of statistics that can be requested from Stat Server. You then create sections in the Workspace Application object that correspond to the statistic names in the statistic.yaml file that you want to use. Finally, you configure the KPI and Contact Center Statistics options to display the statistics to your agents.

statistics.yaml Setup

Workspace reports statistics based on the statistic names in the statistics.yaml file which is included with Web Applications and Services. The file contains all of the statistics that Workspace 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. The name of the statistic is OutboundCalls. To use this statistic, create a section in the WS_Cluster application object by using Genesys Administrator (or Configuration Manager) such as KPI-OutboundCalls, then create an option in the section called statistic-name and assign OutboundCalls as the value. You can also create an option in the section called description and specify the value as Total number outbound calls. 

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

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.

KPIs

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

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 is an example of how to specify the InboundCalls statistic for display:

  1. Choose a statistic from the statistics.yaml file that you want to display, such as InboundCalls.
  2. Create a section in the WS_Cluster application object by using Genesys Administrator (or Configuration Manager) such as KPI-InboundCalls
  3. Create an option in the section called statistic-name.
  4. Assign InboundCalls as the value.
  5. (Optional) You can create other options in the section to specify a display name, such as description with the value as Total number inbound calls.
    The attributes that you can specify include:
    • statistic-name(mandatory)
    • target-value
    • warning-level-low
    • warning-level-high
    • error-level-low
    • error-level-high
    • worst-value-low
    • worst-value-high
    • statistic-type — possible values are: duration, number. If statistic-type isn't specified, the default type is number excepted if the statistics name includes the duration keyword.
    • measurement-unit — an optional display value.

    Refer to Setting the Warning, Error, and Worst Levels for more information about how to use the target, warning, error, and worst attributes.

  6. Repeat steps 1 through 5 for each statistic that you want to use.
  7. In the interaction-workspace section in the WS_Cluster application, specify the name of the section that you created in Step 2 as one of the values of the kpi.displayed-kpis option. The value of this option is a coma-separated list of section names defined in the WS_Cluster application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface. For example: KPI-InternalCalls,KPI-OutboundCalls,KPI-InboundCalls,KPI-CurrentTargetState,KPI-CurrNumberInCall
    Example of the KPI-InboundCalls section

Contact Center Statistics

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.

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 is an example of how to specify the AverageWaitingTime statistic for display:

  1. Choose a statistic from the statistics.yaml file that you want to display, such as InboundCalls.
  2. Create a section in the WS_Cluster application object by using Genesys Administrator (or Configuration Manager) such as CC-AverageWaitingTime
  3. Create an option in the section called statistic-name.
  4. Assign AverageWaitingTime as the value.
  5. (Optional) You can create other options in the section to specify a display name, such as description with the value as Average Customer Wait Time.
    The attributes that you can specify include:
    • statistic-name(mandatory)
    • target-value
    • warning-level-low
    • warning-level-high
    • error-level-low
    • error-level-high
    • worst-value-low
    • worst-value-high
    • statistic-type — possible values are: duration, number. If statistic-type isn't specified, the default type is number excepted if the statistics name includes the duration keyword.
    • measurement-unit — an optional display value.

    Refer to Setting the Warning, Error, and Worst Levels for more information about how to use the target, warning, error, and worst attributes.

  6. Repeat steps 1 through 5 for each statistic that you want to use.
  7. In the interaction-workspace section in the WS_Cluster application, specify the name of the section that you created in Step 2 as one of the values of the statistics.displayed-statistics option. The value of this option is a coma-separated list of section names defined in the WS_Cluster application. Specify the statistics in the order in which you want the statistics to be displayed in the Workspace interface. For example: CC-AverageWaitingTime,CC-Current_In_Queue,CC-CurrMaxCallWaitingTime,CC-ServiceLevel,CC-Total_Abandoned,CC-Total_Answered
    Example of the CC-AverageWaitingTime section
  8. Specify the queue group, agent group, routing point, and/or virtual queue for which you want statistics reported by using the following options:
  9. Specify the refresh time, in seconds, for the statistics in the Contact Center Statistics tab by using the statistics.refresh-time option.

Setting the Warning, Error, and Worst Levels

Workspace provides eight non-mandatory options that you can use to define low and/or high levels of warning and error and low and/or high levels of worst values.

Some statistics are in an error state when they are below a certain value, while others are in an error state when they are above a certain value; for some statistics both a lower error threshold and a higher error threshold are required. The following non-mandatory options enable you to set a low and high threshold for a statistic:

  • error-level-low—Values below this value are in an error state for the statistic.
  • error-level-high—Values above this value are in an error state for the statistic.

Some statistics are in a warning state when they are below a certain value, while others are in a warning state when they are above a certain value; for some statistics both a lower warning threshold and a higher warning threshold are required. The following non-mandatory options enable you to set a low and high threshold for a statistic:

  • warning-level-low—Values below this value are in a warning state for the statistic.
  • warning-level-high—Values above this value are in a warning state for the statistic.

Use the error and warning options to specify ranges that are most suitable for the statistic.

Some statistics are performance based. The agent's result is compared to a target value to determine the agent's level of performance. Some statistics require a lower worst value and some require a higher worst value. For some statistics, both a lower and a higher worst value are required.

  • worst-value-low—Values below this value result in a negative evaluation for the KPI.
  • worst-value-high—Values above this value result in a negative evaluation for the KPI.
  • target-value—The target value to be reached by the agent.
  • evaluation-display—Specifies which value is displayed to the agent, a performance indicator or the raw statistic in the format of the statistic (for example, number, date, or percentage). If the option is set to Result, the actual statistic value is displayed. If the option is set to Evaluation, the performance of the agent is calculated by using the following formulae:

If the statistic value is lower than the target value, the following evaluation is applied: Agent Performance = (Agent Result - worst-value-low) / (Target Value -worst-value-low) x 100 or: If the statistic value is higher than the target value, the following evaluation is applied: Agent Performance = (worst-value-high - Agent Result) / (worst-value-high - Target Value) x 100

Example of a Statistics Configuration file for Workspace

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 was 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!