Interaction Concentrator
Also known as ICON. A Genesys product that collects and stores detailed data from various sources in a contact center that is empowered by using Genesys software. Downstream reporting systems can access Interaction Concentrator data in near–real time.
Operating on top of Genesys Framework, the product consists of a server application that is called ICON and a database that is called Interaction Database (IDB). The server receives data from data sources such as Configuration Server, T-Server, or particular Genesys solutions; it then stores this data in IDB by using Genesys DB Server.
Glossary
populate-thread-facts
Section: gim-etl-populate
Default Value: false
Valid Values: true, false
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.5.001
Enables or disables the population of thread-related metrics in the ANCHOR_FLAGS dimension in multimedia deployments.
max-call-duration
Section: gim-etl
Default Value: 3600
Valid Values: 0 or any positive integer
Changes Take Effect: On the next ETL cycle
Dependencies: None
Specifies the maximum duration, in seconds, of voice interactions in the deployed environment, as well as a number of important timeouts for both voice and multimedia interactions.
g:index-interval
Section: elasticsearch-<data-source-id>
Default Value: No default value
Valid Values: Duration in days or ISO8601 duration format
Changes Take Effect: On the next ETL cycle
Dependencies: None
Introduced: 8.5.013.06
Specifies the maximum expected interval, or range of data, stored in a single Elasticsearch index. The option enables you to override the default Elasticsearch index interval.
If the data source uses indices that can have different intervals, set the value of this option to the largest possible interval. For example, if the data source uses an index that sometimes contains three days of data and sometimes contains five days of data, set g:index-interval=5.
chunk-size
Section: gim-transformation
Default Value: 7200
Valid Values: Any nonnegative integer
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.5.013.06
Modified: .5.015.19 (behavior changed with respect to Elasticsearch data)
Specifies the maximum size of the time interval, in seconds, for which transformed data is committed in one transaction.
- For data that comes through ICON and IDB, the option applies to transformation of Multimedia and Outbound Contact details.
- A value of 0 means that the transformation job takes chunks from GIDB based on extraction high-water marks (HWMs) and audit keys generated by the extraction job. In this case, the transformation chunk size does not exceed the chunk size for extraction, as specified by the extract-data-chunk-size option.
- A value greater than 0 means that the transformation job takes chunks from GIDB based on the value of chunk-size and the previous transformation HWM, without regard to audit keys set by the extraction job.
- For data that comes through Elasticsearch:
- In releases earlier than 8.5.015.19, the transformation job always uses the value of extract-data-chunk-size to set the chunk size for transformation.
- Starting with release 8.5.015.19, the transformation job uses the smaller of extract-data-chunk-size and chunk-size to determine the chunk size to use for Elasticsearch data transformation.
- For data that comes through Kafka, starting with release 8.5.015.19 the chunk size logic is similar to the logic applied to Elasticsearch data.
For data that comes from IDB, Genesys expects that the value of chunk-size (default value 2 hours) will usually be greater than the value of extract-data-chunk-size (default value 15 minutes). When Genesys Info Mart extraction and transformation are running normally with frequent ETL cycles, the amount of data available for transformation is smaller than the chunk-size option, and all available data is transformed. In cases where there is a transformation backlog, a chunk-size value greater than extract-data-chunk-size will enable transformation to catch up with extraction quickly.
However, attempting to transform a large amount of data in one chunk can lead to performance issues or OutOfMemory errors. In cases where there is a very large backlog or where a very large quantity of data has been extracted (for example, because extract-data-chunk-size has been set to a large value and/or "runaway strategy" scenarios have occurred), temporarily reducing the value of the chunk-size option, even to a value smaller than extract-data-chunk-size, enables Genesys Info Mart to process abnormally large amounts of data more efficiently, eventually catching up with extraction.
8.5.013.06
Genesys Info Mart Release Notes
Release Date | Release Type | Restrictions | AIX | Linux | Solaris | Windows |
---|---|---|---|---|---|---|
04/24/19 | Update | X | X | X | X |
Contents
Helpful Links
Releases Info
Deployment Procedure
Product Documentation
Genesys Products
What's New
This release contains the following new features and enhancements:
- Enhanced omnichannel reporting — Two new columns in the SM_MEDIA_NEUTRAL_STATE_FACT table, END_DATE_TIME_KEY and RESOURCE_GROUP_COMBINATION_KEY, enhance support for reporting across all media channels. (GIM-12296)
- Multimedia and Outbound Contact transformation enhancement — A new configuration option, chunk-size in the [gim-transformation] section, enables you to decouple the chunk size for transformation of Multimedia and Outbound Contact details from the chunk size for data extraction. You can use this option to temporarily reduce transformation chunk size, to improve transformation performance and help avoid OutOfMemory errors in situations where there is an unusually large quantity of data to be transformed (for example, because "runaway strategy" scenarios have occurred). (GIM-12238)
- Support for variable-sized Elasticsearch indices — A new configuration option, g:index-interval in the [elasticsearch-<data-source-id>] section(s), enables you to override the default Elasticsearch index interval, so that Genesys Info Mart correctly processes Elasticsearch indices where the size of the index interval is not fixed. (GIM-12266)
- Support for Call Detail Records (CDRs) — In preparation for future support of CDRs for billing or other monitoring purposes, new CDR_* tables have been added to the Info Mart database schema. The make_gim SQL scripts have been modified to include the new table definitions and KVP mappings. Although the CDR_* tables are populated in cloud deployments, they are considered reserved for internal use. (GIM-12255)
- Logging Enhancements — A new log event, 55-20174, supports improved handling of Outbound Contact scenarios where Campaign Group dialing modes are configured with unsupported values. For more information, see GIM-12305.
Resolved Issues
This release contains the following resolved issues:
In scenarios where the export job has been scheduled and Genesys Info Mart is subsequently restarted, Genesys Info Mart now resumes the export job schedule. Previously in such scenarios, Genesys Info Mart reset the schedule and executed the export job immediately after restart. (GIM-12334)
In high availability (HA) deployments where the extraction job extracts Voice details from an Interaction Concentrator instance in which the server (ICON1) has been running for longer than the value of max-call-duration, the extraction job no longer switches to start extracting from an Interaction Concentrator instance in which the server (ICON2) started later. Previously in this scenario, the extraction job could switch from IDB1 to IDB2 and, as a result, could fail to extract calls that were available in IDB1 but not in IDB2. (GIM-12319)
The transformation job no longer uses parallel threads or connections to update the same internal staging table. Previously, in deployments where the option populate-thread-facts was configured as true, session locks on a staging table might have prevented the transformation job from completing. (GIM-12314)
The extraction job no longer generates a NullPointerException error in either of the following scenarios:
- The extraction job is executed with -dap or -role parameters.
- ICONs are connected to servers that are part of a data domain for which the Info Mart connection has no suitable roles configured for IDB DAPs. For example, an ICON is connected to the IxnServer, but there are no IDB DAPs with the role ICON_MM.
Previously in such scenarios, the job sometimes produced a NullPointerException error, and logged a message similar to the following:
2019-03-11 15:12:58,547 WARN ecp-a 20049 Job step 'EXTRACT' failed. null.
java.lang.NullPointerException
at com.genesyslab.gim.etl.jobs.extract.InitialExtractStepTs.isTableAvailableInDsType(InitialExtractStepTs.java:1160)
at com.genesyslab.gim.etl.jobs.extract.InitialExtractStepTs.fillNodataSlices(InitialExtractStepTs.java:619)
at com.genesyslab.gim.etl.jobs.extract.InitialExtractStepTs.initAndFillSlices(InitialExtractStepTs.java:450)
at com.genesyslab.gim.etl.jobs.extract.InitialExtractStepTs.runStep(InitialExtractStepTs.java:110)
(GIM-12310)
In scenarios where Campaign Group dialing modes are configured with unsupported values (that is, with values other than those given in the DIALING_MODE table), the transformation job no longer fails. In such scenarios, Genesys Info Mart now replaces the incorrect data with the default value (0), continues processing, and logs a message (55-20174) similar to the following:
Illegal dialing mode [code] in [column] for chainguid [chainguid] will be treated as 0
Previously in such scenarios, the transformation job failed, producing an error about java.lang.IllegalArgumentException.
(GIM-12305)
In scenarios involving chat interactions that include conferences, the transformation job now correctly populates the IRF_ANCHOR_TS column in the INTERACTION_RESOURCE_FACT table. Previously in such scenarios, if the transformation job processed the data in more than one chunk, records in the table sometimes had incorrect values for IRF_ANCHOR_TS. (GIM-12300)
Genesys Info Mart now provides correct information when notifying Reporting and Analytics Aggregates (RAA) about late After-Call Work (ACW) in the INTERACTION_FACT, INTERACTION_RESOURCE_FACT, and IXN_RESOURCE_STATE_FACT tables. Previously in some scenarios, notifications for late ACW did not reflect the correct START_DATE_TIME_KEY for the associated fact. (GIM-11545)
Upgrade Notes
Refer to the Deployment Procedure for this release to deploy the installation package within your environment.
Dependencies
- To enable all of the functionality provided in this release, Genesys Info Mart requires Interaction Concentrator (ICON) release 8.1.514.11 or higher. At a minimum, Genesys Info Mart release 8.5 requires Interaction Concentrator 8.1.100.36. For additional recommendations, see ICON Recommendations in the Known Issues and Recommendations section.
- Genesys recommends that you manage jobs using Genesys Info Mart Manager, but if you continue to use Genesys Info Mart Administration Console, Genesys recommends that you use Genesys Info Mart Administration Console release 8.1.3 or higher.
- Genesys Info Mart Manager release 8.5.010 requires Genesys Info Mart release 8.5.009 or higher. Genesys Info Mart release 8.5 is compatible with Genesys Info Mart Manager release 8.1.4 and higher.
- Genesys Info Mart Manager and Genesys Administrator Extension (GAX) interoperability requirements are reciprocal:
- Genesys Info Mart Manager release 8.5.010.02 and later requires GAX release 8.5.270.06, and vice versa.
- Genesys Info Mart Manager 8.5 releases earlier than 8.5.010 require GAX 8.5 releases earlier than GAX 8.5.270.06, and vice versa.