Jump to: navigation, search

Genesys Pulse Configuration Options

The application templates for Genesys Pulse might contain other configuration options that are not described in this chapter. These options must remain set to the default values that are provided in the application templates. Changing these values might cause unexpected behavior.

You are not required to configure any options to start Genesys Pulse. Genesys Pulse supplies default values for all options that it requires to function.

GAX Application Object

[pulse] Section

cache_expire_timeout
Valid Values: zero or any positive number
Default Value: 1200
Changes Take Effect: After restart
Specifies how long, in seconds, that Genesys Pulse stores the results of the object accessibility check in order to reduce the load on the Configuration Server.

database_max_active_connections
Valid Values: any positive number
Default Value: 8
Changes Take Effect: After restart
Specifies the database connection pool size, which limits the maximum number of connections to the Genesys Pulse database. If you see large unexpected delays when you update dashboard or widgets, check the number of active database connections, and, if above the maximum, increase this parameter to improve performance.

Important
To ensure the proper Genesys Pulse behavior, Genesys recommends to set the value of the database_max_active_connections option to 8 or higher number.


editable_templates
Valid Values: true,false
Default Value: false
Changes Take Effect: After restart
Enables users with appropriate permissions to edit Genesys-provided templates. If false, even an Administrator cannot edit the default templates. Use this option to remove obsolete or unused templates (for example, iWD or Email). Use in conjunction with the install_templates option.

enable_manual_collector_binding
Valid Values: true,false
Default Value: false
Changes Take Effect: After restart, also requires the refresh of your browser page
Enables the ability to manually specify which Genesys Pulse Collector is used to calculate the statistics of a predefined templates or certain widgets. Users should have the Pulse Manually Bind Collectors role assigned in configuration in order to used this ability.

health_expire_timeout
Valid Values: zero or any positive number
Default Value: 30
Changes Take Effect: After restart
Specifies how long, in seconds, Genesys Pulse stores result of previous health check, which includes the heartbeat, DB connection, and Configuration Server connection.

install_templates
Valid Values: true,false
Default Value: true
Changes Take Effect: After restart
Used in conjunction with the editable_templates option, specifies whether Genesys Pulse installs or updates the Genesys-provided templates for the current release when Genesys Pulse starts. In most cases, when editable_templates is true this option should be set to false.
For example, if you set editable_templates option to true, delete or edit some templates and the install_templates option is set to true, then Genesys Pulse restores all original Genesys-provided templates after restart for the current release. Genesys Pulse restores only templates from the current release, not earlier releases, which may be obsolete.

max_widgets_per_user
Valid Values: zero or any positive number
Default Value: 0
Changes Take Effect: After restart
Specifies the maximum number of widgets for all dashboards. This value is the total sum of widgets for each user. A 0 value means users can have unlimited widgets.

nav_bar_items
Valid Values: specially formed JSON string
Default Value: not specified
Changes Take Effect: After the browser page refresh
Allows to embed custom links to any third-party website in the Navigation bar.
For example, to setup the Advisors menu in Genesys Pulse you need to specify the value as a single string:
{"id":"nav_adv","name":"Advisors","type":"main-item","children":[{"id":"nav_adv_cca","name":"Contact Center Advisor","type":"sub-item","route":"http://<host>/adv/"},{"id":"nav_adv_wfa","name":"Workforce Advisor","type":"sub-item","route":"http://<host>/adv/"},{"id":"nav_adv_fa","name":"Frontline Advisor","type":"sub-item","route":"http://<host>/adv/"}]}
where the route property is set according to the Advisors access URL in your environment.

site
Valid Values: any string
Default Value: not specified
Changes Take Effect: After restart
Specifies the site name where Genesys Pulse is installed. If specified, Genesys Pulse reads snapshot data only from the connected Genesys Pulse Collectors with the same site option specified in the [collector] section.

snapshot_expire_timeout
Valid Values: zero or any positive number
Default Value: 24
Changes Take Effect: After restart
Specifies how long, in hours, that the snapshot file remains before Genesys Pulse automatically removes it. This setting should be no more than 24 hours, unless you plan to provide enough disk space to store additional snapshots. Set it to 0 to disable automatic removal.

Genesys Pulse Collector Application Object

[collector] Section

dbthread
Change takes effect: After restart
Valid values: yes, no
Default value: no
Enables or disables running of embedded DB Server in Genesys Pulse Collector internal thread.

hostname
Valid Values: Valid host name
Default Value: Empty value
Changes Take Effect: After restart
Specifies the Simple Network Management Protocol (SNMP) host name.

management-port
Valid Values: Positive integers
Default Value: No default value
Warning! No other application should use this port.
Changes Take Effect: After restart
Specifies the TCP/IP port that Genesys Pulse Collector reserves for SNMP Option Management Client connections. If this option is absent or null, a server for Management Client is not created.
Warning! You must specify a value for this option if you are using an SNMP connection. Do not change the value for this option while Genesys Pulse Collector is running.

site
Valid Values: any string
Default Value: not specified
Changes Take Effect: After Genesys Pulse restart
Specifies the site name where Genesys Pulse Collector is installed. If specified, only the Genesys Pulse with the same site option specified in the [pulse] section reads the snapshot data from this Genesys Pulse Collector.

[configuration-monitoring] Section

check-layout-presence-timeout
Valid Values: 0-3600
Default Value: 900
Changes Take Effect: After restart
Specifies how often, in seconds, Genesys Pulse Collector checks for the deleted layouts. A zero (0) value completely disables the check.
Note: This defines the minimum timeout between two checks. The actual timeout depends on the database polling cycle, because the check is conducted after finishing subsequent database polling cycle.

db-poll-period
Valid Values: 3-3600
Default Value: 30
Changes Take Effect: After restart
Specifies how often, in seconds, Genesys Pulse Collector obtains updates from the Genesys Pulse database.
Note: Genesys recommends that you set this option to no less than 15 seconds.

excluded-objects-propagation-delay
Valid Values: 0...3600
Default value: 60
Changes Take Effect: Immediately
Specifies the delay in seconds before Genesys Pulse Collector attempts to propagate excluded objects in the affected layouts after an object is deleted. A zero value eliminates the timeout and Genesys Pulse Collector attempts to propagate excluded objects immediately after an object is deleted.

metagroup-contents-recheck-delay
Valid Values: 0...3600
Default Value: 60
Changes Take Effect: Immediately
Specifies the delay in seconds between when Genesys Pulse Collector verifies metagroup contents (such as Agent Group, Place Group, and DN Group) after notification from Configuration Server notifies Genesys Pulse Collector about changes in the contents of the metagroup object. Zero value of this option eliminates timeout and metagroup change is processed immediately.
Note: This configuration option impacts ANY changes in the metagroup (for example, both adding and deleting objects), so new objects added to the metagroup appear in the layout after the specified delay.

new-object-delay
Valid Values: 0-86400
Default Value: 0
Changes Take Effect: Immediately
Specifies the delay, in seconds, between when Genesys Pulse Collector receives notification of a new object in Configuration Server, and when it starts to process this notification. Setting this option to 0 enables Genesys Pulse Collector to process new objects without delays.

ods-wait-timeout
Valid Values: 10–3600
Default Value: 300
Changes Take Effect: After restart
Specifies the time, in seconds, that Genesys Pulse Collector waits before re-checking the Genesys Pulse database for proper initialization.

remove-dynamic-object-delay
Valid Values: 0-600
Default Value: 60
Changes Take Effect: After restart
Specifies the time, in seconds, that Genesys Pulse Collector waits before excluding and closing statistics for the Agent from affected layout that was excluded from the Stat Server-based VAG. A zero value turns off the delay and Genesys Pulse Collector processes changes immediately.

[heartbeat] Section

Important
  • GAX uses the output-folder, heartbeat-folder, and latest-snapshot-output-folder options when it is configured on the same host as Genesys Pulse Collector or if there is no corresponding external option configured.
  • GAX uses the external-*-folder options (if configured) when it is configured on a different host from Genesys Pulse Collector and the external-output-folder option is specified.
  • GAX uses the external-*-url folder when it is configured on a different host from Genesys Pulse Collector and no external-output-folder option is specified.

external-heartbeat-folder
Valid Values: Network or locally mounted path to the heartbeat-folder accessible from a remote GAX instance.
Default Value: No value
Changes Take Effect: After GAX restart
Enables a remote GAX instance to access the Genesys Pulse Collector heartbeat. This option must be used together with the heartbeat-folder.
Note: Relative file paths must begin with ./

external-heartbeat-url
Valid Values: valid HTTP URL to a heartbeat's folder on WebDAV server. For example, http://host1:8080/heartbeat
Default Value: No value
Changes Take Effect: After GAX restart
Description: Enables a remote GAX instance to access heartbeat through WebDAV server. This option must be used together with the heartbeat-folder. The value of this option is ignored by GAX in case when Genesys Pulse Collector and GAX are configured on the same Host or external-output-folder option is specified.

heartbeat-folder
Valid Values: Valid folder path
Default Value: ./output/heartbeat (as provided by template file)
Changes Take Effect: After restart
Specifies the path in which Genesys Pulse Collector writes the heartbeat file.
Note: Relative file paths must begin with ./

heartbeat-period
Valid Values: 3-3600
Default Value: 120
Changes Take Effect: After restart
Specifies the period of a heartbeat update, in seconds.

heartbeat-success-condition
Valid Values:
One or any combination of the following conditions:

  • statserver—Stat Server connection should be available.
  • snapshot-writer—The snapshot writer should be producing outputs without error.
  • db-poller—The polling of Genesys Pulse database should not fail.
  • collector-db—The connection to Genesys Pulse database should be established.

Default Value: statserver, snapshot-writer
Changes Take Effect: After restart
Specifies a comma-separated list of conditions to be checked for criteria of heartbeat success, which means the heartbeat is updated only if this criteria is met.

[layout-validation] Section

enable-layout-validation
Valid Values: yes,no
Default Value: yes
Changes Take Effect: After restart
Enables or disables layout validation in Genesys Pulse Collector.
Note for releases prior to 8.5.103: Genesys Pulse Collector always checks for consistency of LayoutID and TenantID. These validations apply even if options are set to a value no.

validate-strict-tenant-security
Valid Values: yes,no
Default Value: yes
Changes Take Effect: After restart
Discontinued: as of 8.5.103
Enables Genesys Pulse Collector to fail the layout validation when the option strict-tenant-security in the configuration-monitoring section is set to yes and Genesys Pulse encounters an individual object that belongs to a tenant that is different than layout's tenant.

[limits] Section

max-formulas-per-layout
Valid Values: 1-100000
Default Value: 50
Changes Take Effect: After restart
Specifies the maximum number of formula-based statistics for each layout.

max-metagroups-per-layout
Valid Values: 1-10000
Default Value: 50
Changes Take Effect: After restart
Specifies the maximum number of metagroups for each layout.

max-objects-per-layout
Valid Values: 1-100000
Default Value: 100
Changes Take Effect: After restart
Specifies the maximum number of objects for each layout.

max-statistics-per-layout
Valid Values: 1-100000
Default Value: 100
Changes Take Effect: After restart
Specifies the maximum number of statistics for each layout.

[Log] Section

all
Valid Values:

  • stdout—Log events are sent to the Standard output (stdout).
  • stderr—Log events are sent to the Standard error output (stderr).
  • network—Log events are sent to Message Server, which can reside anywhere on the network. Message Server stores log events in the Log Database.

    Setting the all log-level option to network enables Data Sourcer to send log events of Standard, Interaction, and Trace levels to Message Server. Log events of Debug level are neither sent to Message Server nor stored in the Log Database.

  • memory—Log events are sent to the memory output on the local disk. This output is the safest in terms of the application performance.
  • [filename]—Log events are stored in a file with the specified name. If you do not specify a path, the file is created in the application’s working directory.

Default Value: stdout
Changes Take Effect: Immediately
Specifies the outputs to which Data Sourcer sends all log events. You must separate log-output types with commas when you configure more than one output type.
For example, all = stdout, logfile
Notes:

  • To ease the troubleshooting process, consider using unique names for log files that different applications generate.
  • Relative file paths must begin with ./

buffering
Default Value: false
Valid Values: true,false
Changes Take Effect: Immediately
Specifies whether the operating system file buffering is on or off. This option applies only to stderr and stdout output. Setting this option to true increases output performance.
Note: When you enable buffering, log messages might appear in the log after a delay.

collector-log-level
Default Value: Info
Valid Values: Debug, Trace, Info, Warning, Error, Fatal (case insensitive)
Changes Take Effect: Immediately
Defines log level for Genesys Pulse Collector log messages. Messages with severity below this level will not be logged.
Message severity levels:

  • Debug—detailed debug messages.
  • Trace—detailed informational and progress messages.
  • Info—brief informational and progress messages.
  • Warning—minor recoverable errors or situations.
  • Error—severe, but recoverable errors.
  • Fatal—severe, unrecoverable errors.

Note: This option was introduced in Genesys Pulse Collector release 8.5.106. Log output of earlier Genesys Pulse Collector releases corresponds to the current Trace log level. For release 8.5.106 or later, the [log]/verbose option must be set to all in order to see log messages configured in the collector-log-level option.

segment
Valid Values:

  • false—No segmentation allowed.
  • <number> KB or <number>—Sets the maximum segment size in kilobytes. The minimum segment size is 100 KB.
  • <number> MB—Sets the maximum segment size, in megabytes.
  • <number> hr—Sets the number of hours for which the segment stays open. The minimum number is 1 hour.

Default Value: 10 MB
Changes Take Effect: Immediately
Specifies if there is a segmentation limit for a log file. If there is, this option sets the unit of measurement along with the maximum size. If the current log segment exceeds the size set by this option, the current file is closed and a new file is created.

verbose
Valid Values:

  • all—All log events (that is, log events of Standard, Trace, Interaction, and Debug levels) are generated if you set the debug-level option in the statserver section to all.
  • debug—The same as all.
  • trace—Log events of the Trace and higher levels (that is, log events of Standard, Interaction, and Trace levels) are generated, while log events of the Debug level are not generated.
  • interaction—Log events of the Interaction and higher levels (that is, log events of Standard and Interaction levels) are generated, while log events of the Trace and Debug levels are not generated.
  • standard—Log events of the Standard level are generated, while log events of the Interaction, Trace, and Debug levels are not generated.
  • none—Produces no output.

Default Value: all
Changes Take Effect: Immediately Determines whether a log output is created. If it is, this option specifies the minimum level of log events that are generated. The log-event levels, starting with the highest-priority level, are Standard, Interaction, Trace, and Debug.
Refer to the Framework Deployment Guide or Framework Solution Control Interface Help for more information on the Standard, Trace, Interaction, and Debug log levels.

[object-name-format] Section

You can use a custom format for an object name, which can include a mix of predefined text and additions to the object properties within their actual values with optional width and trimming rules. For details, see “Valid object name format string” and “Object Information”.

AccessResource
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Access Resource. For details, see “Object Properties” at the bottom of this section.

ACDPosition
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype ACD Position. For details, see “Object Properties” at the bottom of this section.

ACDQueue
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for the object of the of type DN with subtype ACD Queue. For details, see “Object Properties” at the bottom of this section.

Agent
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for the object of the of type Agent. For details, see “Object Properties” at the bottom of this section.

AgentGroup
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for the object of the of type Agent Group. For details, see “Object Properties” at the bottom of this section.

CallingList
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Calling List. For details, see “Object Properties” at the bottom of this section.

Campaign
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Campaign. For details, see “Object Properties” at the bottom of this section.

CampaignCallingList
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Campaign Calling List. For details, see “Object Properties” at the bottom of this section.

CampaignGroup
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Campaign Group. For details, see “Object Properties” at the bottom of this section.

Cellular
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Cellular. For details, see “Object Properties” at the bottom of this section.

Chat
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Chat. For details, see “Object Properties” at the bottom of this section.

CoBrowse
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype CoBrowse. For details, see “Object Properties” at the bottom of this section.

CP
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype CP. For details, see “Object Properties” at the bottom of this section.

Data
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Data. For details, see “Object Properties” at the bottom of this section.

DN
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN. For details, see “Object Properties” at the bottom of this section.

DNGroup
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN Group. For details, see “Object Properties” at the bottom of this section.

EAPort
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype EA Port. For details, see “Object Properties” at the bottom of this section.

Email
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Email. For details, see “Object Properties” at the bottom of this section.

Extension
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Extension. For details, see “Object Properties” at the bottom of this section.

ExtRoutingPoint
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Ext Routing Point. For details, see “Object Properties” at the bottom of this section.

FAX
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Fax. For details, see “Object Properties” at the bottom of this section.

Mixed
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Mixed. For details, see “Object Properties” at the bottom of this section.

Music
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Music. For details, see “Object Properties” at the bottom of this section.

Place
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Place. For details, see “Object Properties” at the bottom of this section.

PlaceGroup
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Place Group. For details, see “Object Properties” at the bottom of this section.

RoutingPoint
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Routing Point. For details, see “Object Properties” at the bottom of this section.

RoutingQueue
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Routing Queue. For details, see “Object Properties” at the bottom of this section.

RoutingStrategy
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Routing Strategy. For details, see “Object Properties” at the bottom of this section.

Script
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Script. For details, see “Object Properties” at the bottom of this section.

ServiceNumber
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Service Number. For details, see “Object Properties” at the bottom of this section.

StagingArea
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Script with subtype Staging Area. For details, see “Object Properties” at the bottom of this section.

Switch
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Switch. For details, see “Object Properties” at the bottom of this section.

Tenant
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Tenant. For details, see “Object Properties” at the bottom of this section.

Video
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Video. For details, see “Object Properties” at the bottom of this section.

VirtACDQueue
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Virt ACD Queue. For details, see “Object Properties” at the bottom of this section.

VirtRoutingPoint
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Virt Routing Point. For details, see “Object Properties” at the bottom of this section.

VoiceMail
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Voicemail. For details, see “Object Properties” at the bottom of this section.

VoIP
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype VoIP.

Workbin
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type Script with subtype Workbin. For details, see “Object Properties” at the bottom of this section.

Workflow
Valid Values: Valid object name format string. For details, see the table at the bottom of this section.
Default Value: %ObjectName%
Changes Take Effect: After restart
Specifies the object name formatting rule for an object of type DN with subtype Workflow For details, see “Object Properties” at the bottom of this section.

Valid object name format string

The valid object name format string is free text string, which allows values of object properties:
%<PropertyName>:<side><padding><length>%

  • PropertyName—Specifies the property name.
    Note:Property names are case sensitive.
  • side—Specifies the side, L (left) or R (right) , from where the length must be counted. If you do not specify a side, Genesys Pulse uses L by default.
    L is commonly used for string or text properties.
    R is commonly used for numbers.
  • padding—Specifies the padding when the property value length is less than the specified custom length
    . (dot) to pad with space characters
    0 (zero) to pad with zero characters.
  • length—Specifies the maximum number of characters for the property name.
Valid Object Name Format String Description
  • %EmployeeID:10%
  • %EmployeeID:L10%
Both specify 10 characters of property EmployeeID from the left side.
  • %EmployeeID:.10%
  • %EmployeeID:L.10%
Specifies 10 characters of property EmployeeID from left, but if length was less than 4 symbols, pad it with spaces.
  • %DBID:R4%
Specifies 4 characters of property DBID from the right side.
  • %DBID:R04%
Specifies 4 characters of property DBID from the right side, but if the length is less than 4 characters, pads it with zeros.

Object Properties

The table below lists the object properties available for use in the format strings.

Object Type Property Description
All Object Types CustomName You can specify an object name to use only within Genesys Pulse that is different than the actual object name in the Configuration Server. When this is configured you can see the custom object name in Genesys Pulse widgets, although you still see the original object name when choosing objects for your widget in Genesys Pulse.

This is the useful for Virtual Queues when their Display Name is used in strategies, but not recommended for Genesys Pulse.

To configure a custom Genesys Pulse object name for Configuration Server object:

  1. Set the Object Annex option named display_name, placed in the [pulse] section for one or many objects.
  2. Configure Genesys Pulse Collector to use custom Genesys Pulse Object Name by configuring object name format with format string %CustomName%.
  3. The Object Name format is configured in Genesys Pulse Collector options section [object-name-format].

If the custom name is not defined, the %ObjectName% value is used.

Special case: For the Campaign Calling List (assignment of a Calling List to a Campaign rather than a native Configuration Server object), the custom name is a combination of the custom names of the corresponding Calling List and Campaign name. If some part of this name is not defined, the %ObjectName% value is used.

All Object Types DBID Specifies the ID of the object. For example, Campaign Group is in group DBID, Campaign Calling List is in CallingList ID.
All Object Types ObjectID Specifies the ID number of the object in Genesys Pulse Collector.

Notes:
  • This is the typically the configuration layer DBID, but for some types of objects (for example, Campaign Group, Campaign Calling List) this is a composite 64-bit ID.
  • The composite 64-bit ID is an unsigned 64-bit number with the following composition:
    • higher 32 bits: DBID of Campaign
    • lower 32 bits: DBID of Calling List or Agent/Place group
All Object Types ObjectName Specifies the name of the object, which is written to the snapshot file.
All Object Types ObjectType Specifies the type of the object.
All Object Types TenantID Specifies the Tenant ID of the object.
All Object Types type Specifies the type of the object.
Agent EmailAddress Specifies the email address of the agent (person).
Agent EmployeeID Specifies the employee ID of the agent (person).
Agent ExternalID Specifies the external ID of the agent (person).
Agent FirstName Specifies the first name of the agent (person).
Agent LastName Specifies the last name of the agent (person).
Agent UserName Specifies the user name of the agent (person).
Calling List Description Describes the calling list.
Campaign Description Describes the campaign.
Campaign Calling List CallingListDescription Describes the underlying Calling List object.
Campaign Calling List CallingListName Specifies the DBID of the Calling List object.
Campaign Calling List CampaignDBID Specifies the DBID of the Campaign object.
Campaign Group CampaignDBID Specifies the DBID of the Campaign object.
Campaign Group GroupDBID Specifies the DBID of the group object.
Campaign Group GroupType Specifies the numeric Type of the group object (CFGAgentGroup or CFGPlaceGroup).
DN, Routing Queue, Routing Point Alias Specifies the DN Alias.
DN, Routing Queue, Routing Point AliasOrNumber Populated with the DN Alias if available, otherwise populated with the DN number.
DN, Routing Queue, Routing Point Number Specifies the DN number.
DN, Routing Queue, Routing Point SwitchDBID Specifies the switch DBID.
DN, Routing Queue, Routing Point SwitchID Specifies the switch name.
Routing Strategy, Staging Area, Workbin ScriptType Specifies the script type ID.
Switch DNRange Specifies the switch DN Range.
Switch SwitchType Specifies the switch type.

[output] Section

collector-snapshot-log-level
Valid Values: Debug, Info, Warning, Error, Fatal, Unknown, None (case-insensitive)
Default Value: Warning
Changes Take Effect: After restart
Determines minimum log level for snapshot message that is written to Genesys Pulse Collector log.

max-output-interval
Default Value: 3600
Valid Values: 3–3600
Changes Take Effect: After restart
Specifies the maximum allowed output interval for all report layouts. Users can independently set output frequencies by layout within the Genesys Pulse user interface. If the set frequency, however, is greater than the value of this option, Genesys Pulse uses the value of this option instead.
Note: The value of this option must be greater than the value of the min-output-interval option or Genesys Pulse Collector logs an appropriate error.

min-output-interval
Default Value: 3
Valid Values: 3–3600
Changes Take Effect: After restart
Specifies the minimum allowed output interval for all report layouts. Users can independently set output frequencies by layout within the Genesys Pulse user interface. If the set frequency, however, is less than the value of this option, Genesys Pulse uses the value of this option instead.

snapshot-log-level
Valid Values: Debug, Info, Warning, Error, Fatal, Unknown, None (case-insensitive)
Default Value: Info
Changes Take Effect: After restart
Specifies the minimum log level for a snapshot message that is put into a layout snapshot.

[parallel-processing] Section

inactive-stat-data-processing-thread-gc-threshold
Valid Values: 1-86400
Default Value: 1800
Changes Take Effect: After restart
Defines, how much time, in seconds, Genesys Pulse Collector keeps previously allocated statistical data processing thread, which is currently inactive, before it is collected as garbage object.
Note: This parameter defines the minimum timeout. Actual garbage collection happens the next time Genesys Pulse Collector attempts to activate the layout or after a full configuration recheck cycle for a changed layout.

snapshot-builder-worker-thread-count
Valid Values: 1-128
Default Value: 2
Changes Take Effect: After restart
Defines the number of concurrent threads used to build snapshots.

stat-data-processing-thread-max-load-factor
Valid Values: 1-300
Default value: 300
Changes Take Effect: After restart
Specifies that a dynamic stat data processing pool is used and that the number of threads in that pool have no more layouts than specified in this option for each processing thread.
For example, if you have 1000 widget layouts and this option set to 100 then 10 stat data processing threads are created.

stat-data-processing-thread-pool-size
Valid Values: 0...256
Default Value: 4
Changes Take Effect: After restart
Specifies the number of threads in stat data processing thread pool. If this number is non-zero, then a fixed-size pool with the specified number of threads is used: otherwise; a dynamic-size pool is used, which is controlled by option stat-data-processing-thread-max-load-factor.

use-multiple-stat-data-processing-threads
Possible values: yes,no
Default Value: yes
Changes Take Effect: After restart
Enables multi-threaded statistic data processing.

[scripting] Section

definition-script-execution-timeout
Valid Values: 1-900
Default Value: 45
Changes Take Effect: After restart
Time in seconds allowed for definition script execution.

formula-script-execution-timeout
Valid Values: 1-900
Default Value: 5
Changes Take Effect: After restart
Time in seconds allowed for single formula evaluation script execution.

init-script-execution-timeout
Valid Values: 1-900
Default Value: 60
Changes Take Effect: After restart
Time in seconds allowed for initialization script execution.

js-lib-path
Valid Values: Valid folder paths
Default Value: ./jslib/standard
Changes Take Effect: After restart
Comma-separated list of locations of the directories that contain additional JavaScript libraries to be used within the formula scripting engine.
Note: Relative file paths must begin with ./

js-modules
Valid Values: Comma-separated list of JavaScript files
Default Value: collector.js,cfglib.js,statlib.js,gts.js
Changes Take Effect: After restart
Comma-separated list of modules to preload into the scripting engine.

stop-compute-formula-threshold-for-snapshot
Valid Values: 0-100
Default Value: 3
Change Take Effect: After restart
Specifies the maximum allowed number of timeout expired errors during formula computation, after which, Genesys Pulse Collector assigns the particular formula-based statistic the ERROR value for the current snapshot. A zero value of this option suppresses the limit of the timeout expired failures.

[statistic-request-handling] Section

always-use-statserver-newapi
Valid Values: yes, no
Default Value: no
Changes Take Effect: After restart
Determines whether to force Genesys Pulse Collector to request all statistics through the Stat Server New API that uses the proper parameter set.

data-source-choice-strategy
Valid Values: PrimaryRunMode, LastGood, FirstAvailable, MostUpToDate, PrimaryInCME, Local
Note: All values are case-insensitive.
Default Value: PrimaryRunMode
Changes Take Effect: After restart
Specifies which Stat Server configured in the configuration layer that Genesys Pulse Collector uses as a data source for a snapshot:

  • PrimaryRunMode—Genesys Pulse Collector uses the Stat Server running in the primary mode. If both Stat Servers appear to be backup, Genesys Pulse Collector attempts the next strategy.
  • LastGood—Genesys Pulse Collector uses the last good Stat Server if available. Otherwise, Genesys Pulse Collector attempts the next strategy.
  • FirstAvailable—Genesys Pulse Collector uses the Primary Stat Server if available. If uses the Primary Stat Server is unavailable, Genesys Pulse Collector uses the Backup Stat Server. Otherwise, Genesys Pulse Collector attempts the next strategy.
  • MostUpToDate—Genesys Pulse Collector uses Stat Server that sent statistic data with most recent Server Time. Otherwise, Genesys Pulse Collector attempts the next strategy.
  • PrimaryInCME—Genesys Pulse Collector always uses the Primary Stat Server.
  • Local—Genesys Pulse Collector uses Stat Server installed on the same host. If both Primary and Backup Stat Servers are local or none of them is installed on the same host, then the PrimaryRunMode strategy is applied.

max-stat-data-queue-size
Valid Values: 1-2147483647
Default Value: 2147483647
Changes Take Effect: After restart
Specifies the limit for the internal Genesys Pulse Collector statistical data queue, which stores unprocessed data from Stat Server. Genesys Pulse drops incoming data exceeds this limit. Genesys recommends you set the value of this option to an at least six times the expected maximum total number of statistics.

optimize-statistic-requests
Valid Values: yes, no
Default Value: yes
Changes Take Effect: After restart
Specifies whether to enable statistic request optimization.

statserver-batch-size
Valid Values: 1-10000
Default Value: 500
Changes Take Effect: Immediately
Specifies the number of statistic requests sent to Stat Server in a single packet. The recommended value depends on the number of statistic requests you plan to run, network bandwidth, and processing capabilities of the Stat Server and Genesys Pulse Collector servers. If Stat Server disconnects Genesys Pulse Collector when it is opening statistics with error message Client too slow, decrease value of this option.

statserver-profiles-timeout
Valid Values: 1-86400
Default Value: 600
Changes Take Effect: Immediately
Specifies the timeout, in seconds, to receive and process server profiles from Stat Server. If profiles are not received and processed within the given timeout, Genesys Pulse Collector closes the current connection to Stat Server and attempts to reconnect.

suspend-notifications-from-secondary-server
Valid values: yes, no
Default value: yes
Change takes effect: After restart
Specifies whether Genesys Pulse Collector should attempt to use Stat Server's capability to quickly suspend and resume notifications for all request, when data from a particular Stat Server is not used at the moment to generate snapshots. To use this option, you must have Stat Server release 8.5.102 or later.

suspend-statistic-notifications-for-paused-layouts
Valid Values: yes, no
Default Value: no
Changes Take Effect: After restart
Determines whether to suspend the statistic notifications for paused layouts.
Note: You must have Stat Server version 8.1.200.17 or higher for this functionality to work correctly, if you set the value of suspend-statistic-notifications-for-paused-layouts to yes.

verbose-request-statistics
Valid Values: true, false
Default Value: false
Changes Take Effect: Immediately
Determines whether to enable Genesys Pulse Collector to log verbose messages about the objects for which it requests statistics.

[transport-file] Section

Important
See the important note in the [heartbeat] section to see how GAX uses the folder options.

compression-method
Valid Values: None, LZ4 (case-insensitive)
Default Value: None
Changes Take Effect: After restart
Specifies whether compression should be used and which type of compression to use for the snapshot files.

enable-latest-snapshot-output
Valid Values: yes, no
Default Value: no
Changes Take Effect: After GAX restart
Specifies whether separate output of the latest full snapshot is enabled.

external-latest-snapshot-output-folder
Valid Values: Network or locally mounted path to the latest-snapshot-output-folder that is accessible from a remote GAX instance.
Default Value: No value
Changes Take Effect: After GAX restart
Enables a remote GAX instance to access the latest Genesys Pulse Collector output files. This option must be used together with the latest-snapshot-output-folder. The value of this option is ignored by GAX in cases when both Genesys Pulse Collector and GAX are configured on the same host.

external-latest-snapshot-output-url
Valid Values: Valid HTTP URL to a latest-snapshot-output-folder through WebDAV server. For example, http://host1:8080/latest_snapshot
Default Value: No value
Changes Take Effect: After GAX restart
Enables a remote GAX instance to access latest snapshot through WebDAV server. This option must be used together with the latest-snapshot-output-folder. The value of this option is ignored by GAX in cases when both Genesys Pulse Collector and GAX are configured on the same host or the external-output-folder option is specified.

external-output-folder
Valid Values: Network or locally mounted path to the heartbeat-folder accessible from a remote GAX instance
Default Value: No value
Changes Take Effect: After GAX restart
Enables a remote GAX instance to access the Genesys Pulse Collector output files. This option must be used together with the output-folder.
Note: Relative file paths must begin with ./

external-output-url
Valid Values: valid HTTP URL to a snapshot's folder on WebDAV server. For example, http://host1:8080/output
Default Value: No value
Changes Take Effect: After GAX restart
Enables a remote GAX instance to access snapshots through WebDAV server. This option must be used together with the output-folder. The value of this option is ignored by GAX in case when Genesys Pulse Collector and GAX are configured on the same Host or external-output-folder option is specified.

latest-snapshot-output-folder
Valid Values: Valid file path
Default Value: ./output/latest
Changes Take Effect: After GAX restart
Specifies the path to store the output of the latest full snapshot.
Note: Relative file paths must begin with ./

lz4-compression-level
Valid Values: 1-16
Default Value: 1
Changes Take Effect: After restart
Specifies the compression level for the LZ4 compression method.

output-file-ext
Valid Values: Valid file extensions for your operating system
Default Value: gpb
Changes Take Effect: After restart
Specifies the file extension for the full output file format.

output-file-mode
Valid Values: 0-0777
Default Value: 0664
Changes Take Effect: After restart
On Linux, specifies the UNIX mode for each output file created by this transport.
Important! This option respects umask set at OS level.

output-folder
Valid Values: Valid folder paths
Default Value: No default (the Collector.apd file supplies the value of a sample output directory)
Changes Take Effect: After restart
Specifies the path in which Genesys Pulse Collector writes output files. If you specify a folder that does not exist, Genesys Pulse Collector creates it for you.
Note: Relative file paths must begin with ./

worker-thread-count Valid Values: 1-128
Default Value: 2
Changes Take Effect: After restart
Defines the number of concurrent threads used to write snapshots.

[transport-rabbitmq] Section

disabled
Valid Values: yes, no
Default Value: no
Changes Take Effect: After restart
Disables RabbitMQ messaging.

exchange
Valid Values: A non-empty sequence of these characters: letters, digits, hyphen, underscore, dot, or colon.
Default Value: <None>
Changes Take Effect: After Genesys Pulse Collector restart
Specifies the full name of a RabbitMQ exchange where Genesys Pulse Collector writes delta messages. The value of exchange option should be same for the primary and backup Genesys Pulse Collectors if you want to enable HA for quick updates. This, however, might significantly increase traffic between RabbitMQ nodes. If you use different values for this option for Primary and Backup Genesys Pulse Collectors then the network traffic will be reduced significantly but Quick updates might not work if one of the Genesys Pulse Collectors is down

max-queue-length
Valid Values: 1-10000
Default Value: 1000
Changes Take Effect: After restart
Specifies the maximum number of messages allowed in the queue.

nodes
Valid Values: hostname1:port1, hostnameN:portN
You must specify the port value: 0-65535.
Default Value: localhost:5672
Changes Take Effect: After restart
Lists a single host name with a port for a single node configuration, and all cluster nodes host names and ports for the cluster configuration. Note: If Genesys Pulse Backend and Genesys Pulse Collector it connects to run on one of the hosts in the list, put this host as the first entry in the list.

password
Valid Values: String
Default Value: pulse
Changes Take Effect: After restart
Specifies the password for the username.

reconnect-interval
Valid Values: 0-3600
Default Value: 10
Changes Take Effect: After restart
Specifies the time interval, in seconds, between reconnection attempts.

username
Valid Values: String
Default Value: pulse
Changes Take Effect: After restart
Specifies the username.

vhost
Valid Values: String
Default Value: /pulse
Changes Take Effect: After restart
Specifies the path to the virtual host.

[transport-webdav] Section

Starting with release 8.5.106, the following new configuration options are added:

output-url
Valid Values: Valid URL
Default Value: no default value
Changes Take Effect: After Genesys Pulse restart
WebDAV URL to access snapshots generated by Genesys Pulse Collector. If this option is specified, values of the [transport-file]/external-output-url and [transport-file]/external-output-folder options are ignored.

heartbeat-url
Valid Values: Valid URL
Default Value: no default value
Changes Take Effect: After Genesys Pulse restart
WebDAV URL to access the heartbeat file generated by Genesys Pulse Collector. If this option is specified, values of the [transport-file]/external-output-url and [transport-file]/external-output-folder options are ignored.

latest-snapshot-output-url
Valid Values: Valid URL
Default Value: no default value
Changes Take Effect: After Genesys Pulse restart
WebDAV URL to access the latest snapshots generated by Genesys Pulse Collector. If this option is specified, values of the [transport-file]/external-latest-snapshot-output-url and [transport-file]/external-latest-snapshot-output-folder options are ignored.

username
Valid Values: Any string
Default Value: no default value
Changes Take Effect: After Genesys Pulse restart
The username for authentication on WebDAV Server.

password
Valid Values: Any string
Default Value: no default value
Changes Take Effect: After Genesys Pulse restart
The password for authentication on WebDAV Server.

connection-timeout
Valid Values: 0 - 2147483647
Default Value: 5000
Changes Take Effect: After Genesys Pulse restart
Time, in milliseconds, to wait until the connection to WebDAV Server is established.

This page was last edited on August 25, 2020, at 00:07.
Comments or questions about this documentation? Contact us for support!