Jump to: navigation, search

Source Metrics


In the Source Metric Manager, you manage source metric definitions that come from the Genesys Stat Server data source, also called Statistic definitions.

You can perform the following actions in the Source Metric Manager:

  • View the source metrics.
  • Create and edit new custom source metrics.
  • Delete custom source metrics.

Fields and options on the Source Metric Details page, on which you can create custom source metrics, are dependent on one another. For example, the Subjects drop-down list is populated based on your selection in the Objects list. As you make selections, other lists, options, and fields update to offer only applicable properties.

Use Queue object–type source metrics with both ACD queues and virtual queues.

For information about source metrics and source metric attributes, see documentation for the Real-Time Metrics Engine (Stat Server), particularly the Stat Server User’s Guide and the Reporting Technical Reference.

Supported Media Types

The Source Metric manager supports the following media types for custom source metrics:

  • Voice
  • E-mail
  • Chat
  • Workitem
  • New3.png SMS (starting with release 8.5.2)

Stat Server Current State Source Metrics

New custom source metrics cannot be created for the Stat Server categories of Current State and Current State Reasons. There are source metrics that ship with Advisors for these categories, and the customization available on these metrics is limited. For example, the Reason Code Key is configurable, but it is not possible to extract agent readiness based on capacity rules for a non-voice channel. See also Customizing the Stat Server Current Target State Source Metrics.

The AgentState source metric – derived from the Stat Server Current State category – includes a filtered source metric definition called AgentDN. Frontline Advisor uses the related AgentDN report metric to provide information about the DN extension, ACD position, or multimedia channel into which each agent is logged.

Related Information


Relationships between Source and Report Metrics

The following table lists the relationship between the source metrics and the report metrics on the Report Metrics page.

If you select this object type in the Source Metric Objects field Then the Source Metric will be available for this Report Metric object type
Agent Agent
GroupAgents Agent Group
Queue* Application (queue-based)
New3.png GroupQueues* Application (DN Group-based)
StagingArea Application
CallingList Application
* When you create a new custom source metric using the Mediation DN object group, you can select either the Queue or GroupQueues object, or you can select both. Selecting the Queue object means the source metric will be applicable only to queues. Selecting the GroupQueues object means the source metric will be applicable only to DN groups. If your custom source metric should be applicable to both DN groups and queues, then select both Queues and GroupQueues in the Objects field for the Mediation DN object group.

Source Metrics and RBAC

If you have sufficient privileges to see the Source Metrics page, then you can view all existing statistics definitions. There is no role-based access control on the individual statistic definitions.

RBAC privileges also manage the following:

  • A user’s ability to create custom source metrics
  • A user’s ability to edit source metrics
  • A user’s ability to delete source metrics

See CCAdv/WA Access Privileges and FA Access Privileges for the list of privileges associated with the Source Metric Manager.

Working with Source Metrics

A custom source metric that you create is immediately available for use in the creation of a report metric.

The source metrics that ship with Advisors (default metrics) cannot be edited, with the exception of the Reason Code source metric, for which you can edit the following attributes:

  • Reason code Key
  • Reason Start Overrides Status Start

For users with Edit privileges:

  • The Edit button is present and enabled if a selected metric is a custom metric (not a default source metric).
  • The Edit button is absent or disabled if a selected metric is a default source metric.
  • When editing a source metric with dependent report metrics, a warning message indicates that the edit will affect the dependent metric(s).
  • You cannot change the category for an existing source metric from Current to Historical, nor the reverse.

The source metrics that ship with Advisors (default metrics) cannot be deleted. You can delete a custom source metric provided no report metric is derived from it.

For users with Delete privileges:

  • The Delete button is present and enabled if the selected metric is a custom metric (not a default source metric).
  • When attempting to delete a custom source metric that has dependent report metrics, an error message indicates that you cannot delete the metric because of the dependent report metric(s).

Category Options

A statistic category is either a Current category or a Historical category. The Current category is the current value of the evaluated measurement in the Stat Server. The Historical category means the metric is evaluated over a specific time interval (the time profile).

JavaCategory source metrics can be either Current or Historical; you can specify which to use based on your requirements.

Main Mask/Relative Mask Wild Cards

Wild cards such as * to select all options or ~ to exclude a mask are implicitly supported in the Main Mask and Relative Mask editing windows. Use the Select All feature at the bottom of the editing window to select all options and then selectively deselect one or more options with the radio buttons.

For example, if MainMask = *, ~LoggedOut, do the following in the Main Mask editing window:

  1. Use Select All: Selected to select all the options in the window.
  2. Click the LoggedOut radio button to deselect it.

Filtered Source Metrics

When you select a source metric on the Source Metrics page, the attributes for that metric are displayed in the lower half of the page, including the Filtered Source Metrics table in which you can create a filter for the metric.

To apply a filter to a selected metric, specify the following in the Filtered Source Metrics table:

  • Name of the filter
  • A description for the filter
  • The filter: A filter must be one that is available in the Configuration Server Business Attributes > Advisors Filters section.

You can add as many filters to an unfiltered source metric as you require; each filtered version becomes a new source metric.

You can edit filtered source metric properties. You can also delete a filtered source metric if no report metric is using a filtered variation. This includes filtered source metrics defined on default metrics; they can be edited or deleted.

Each filtered variation is stored on a database table separate from the source metric table.

Finding Filtered Source Metrics in the Source Metrics Manager

Filtered source metrics are variations of other parent source metrics; you can find the filtered source metrics only under the respective parent source metric. For example, to find the filtered variations of a source metric called Retrieved Calls, navigate to the Retrieved Calls source metric and select it. The filtered variations are displayed in the details in the lower half of the page.

Configuring the Media_Workitem Filter as the Business Attribute Value for the Default iWD Source Metrics

Starting in release 8.5.1, Advisors include some intelligent Workload Distribution (iWD) source metrics (not including iWD Datamart metrics). These iWD source metrics include a Media_Workitem filter. Before you enable the iWD metrics, you must configure an attribute value in the Advisors Filters business attribute to correspond to the Media_Workitem filter. Genesys recommends that you configure the Advisors Filters business attribute on a tenant that is the default tenant for the Advisors suite installation (on which you configure all Advisors metadata).

Use the following properties when you configure the Media_Workitem filter attribute value in Configuration Server:

  • name = Media_Workitem
  • description = PairExists("MediaType","workitem")

The name of the filter (Media_Workitem) is case-sensitive; ensure you enter it correctly.

Customizing the Stat Server Current Target State Source Metrics

Starting in release 8.5.001, you can create custom source metrics for the Stat Server category of CurrentTargetState.

In release 8.5.0, the following default metrics were available in the Metric Manager, and were evaluated from the Current Target State source metric. In release 8.5.001, these metrics based on Genesys Stat Server data are no longer shipped with Advisors because you can create your own custom metrics based on the Current Target State metric.

Object Type Report Metric Reporting Application
Application Avail Voice CCAdv
Agent Group Avail Voice CCAdv
Agent Voice Ready CCAdv
Agent Voice Ready FA

Creating a Custom Source Metric for the CurrentTargetState Category

In release 8.5.001, Advisors Genesys Adapter can extract agent media-capacity information from the default Current Target State source metric. An example of media-capacity is the maximum number of chat interactions that an agent can handle simultaneously.

You use the default Current Target State source metric that is supplied with Advisors and the Filtered Current Target State Source Metrics section of the Source Metrics Manager to configure your specific Current Target State attributes. The default Current Target State source metric supports both agent and agent group object types.

Click the Edit button in the Filtered Current Target State Source Metrics section of the Source Metrics Manager for the Current Target State source metric. The following figure shows the Edit button at the bottom of the Source Metrics window.

Pma current-target-state-metric-creation 85001.png

The Create dialog box – instead of presenting filters – offers the following attributes:

  • Type (that is, the Current Target State attribute type; only Media Capacity is available in release 8.5.001)
  • Capacity Media Type
  • Capacity Attribute

All media types registered in the Genesys Configuration Server under Business Attributes > Media Types are listed under the Capacity Media Type option.

The following options are available for Capacity Attribute:

  • Routable Interactions Count (also known as Current Margin Count)
  • Maximum Interactions Count
  • Current Interactions Count

Create an enabled raw report metric for either CCAdv or FA based on each of the source metrics with the filtered media capacity attribute. You can create a raw report metric to display on the dashboard, or you can use the raw report metric to create other calculated report metrics.

Current Target State Metrics and Agent Groups

When the Current Target State metric is reported, AGA extracts the configured media capacity attributes for each agent in an agent group. The corresponding metric at the agent group level is evaluated based on the media capacity attribute at the agent level. Therefore, for all the media capacity attributes that Genesys supports in release 8.5.001, a formula of SUM is used to evaluate the agent group level metric value from the agent level attribute value.

Current Target State Metrics and Metric Applicability

You can configure metric applicability for the custom Current Target State report metrics in the same way that you configure applicability for any other raw report metric.

Example: Using Metrics Based on Current Target State


While an agent might manage many chat or email interactions simultaneously, that same agent can typically manage only one voice interaction at a time. To track an agent's availability for routable voice interactions using metrics on the dashboard, you could create report metrics based on the Current Target State metric that ships with Advisors. For example, the following screenshot shows two custom source metrics – VoiceMax tracks the maximum number of voice interactions for an agent and VoiceRout tracks the availability of the agent to handle a voice interaction.

Custom source metrics based on the default Current Target State source metric

You would then create custom raw report metrics that use those custom source metrics as the foundation. The following screenshot shows an example of custom report metrics.

Custom report metrics that use the previously-created Current Target State–based source metrics

After you create and save the enabled custom report metrics, they are available in the Advisors column chooser so you can display the metrics on the dashboard. In this example, which uses the Frontline Advisor dashboard, the custom report metric that tracks an agent's availability to take calls is the AgentVoiceRoutableInteractions metric. The VoiceMaxInteractions metric tracks the maximum number of voice interactions (calls) an agent can handle simultaneously.

The following screenshot shows one ready agent (J. Davis) and two logged-off agents. Note that the AgentVoiceRoutableInteractions metric indicates that only the agent in the Ready state is available for a voice interaction.

An agent in the Ready state is available to take a call. The AgentVoiceRoutableInteractions metric has a value of 1 for the agent who is ready. The VoiceMaxInteractions metric indicates that the agent can handle a maximum of 1 call at any time.

If that agent should take a break, or be on the phone, the AgentVoiceRoutableInteractions metric indicates that the agent is no longer available for any further calls.

An agent in the Not Ready state is unavailable to take a call. The AgentVoiceRoutableInteractions metric has a value of 0 for the agent in the Not Ready state.
An agent in the Talking state is unavailable to take a call. The AgentVoiceRoutableInteractions metric has a value of 0 for the agent in the Talking state.
This page was last edited on February 8, 2018, at 20:10.
Comments or questions about this documentation? Contact us for support!