This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Vortex release

Vortex release

This section includes key information regarding new features included in Aura Platform for Vortex and main changes in comparison with previous releases

What’s new in Vortex?

Discover here the new features and modifications at a glance. You can find the technical details in the release changelog and the Release Notes.

Novelties Description
Use of Redis as a service in aura-bridge cache ✔️ MongoDB has been replaced by Redis for the management of messages that need to use the Queue.
New event service in aura-bridge ✔️ aura-bridge integrates a new service to emit and listen to events through a centralized service.
Add new metrics in aura-groot ✔️ add new metrics
Add new metrics in aura-bridge ✔️ add incoming_message_duration_seconds for incoming request
Bugfixing in Vortex 8.2.1. version ✔️ Optimization of aura-groot memory handling.
✔️ Fixed how anonymous users information is refreshed in aura-bot caches.
✔️ Modified aura-groot behavior to reduce data retrieval calls for KPIs writing.

1 - Vortex release changelog

Vortex release changelog

Discover the record of all notable changes made in Aura for this release, organized by component

1.1 - Aura system components version

Aura system components versions

Updated versions of Aura system components for the current Aura Platform release

Components versions

All components in the table below run over AKS cluster version 1.26.

Name Namespace Image deployed
alertmanager aura-system devopstf.azurecr.io/tools/alertmanager:v0.23.0
elastic-operator aura-system docker.elastic.co/eck/eck-operator:2.7.0
elasticsearch-es-aura aura-system devopstf.azurecr.io/tools/elasticsearch:8.7.0
elasticsearch-exporter aura-system devopstf.azurecr.io/tools/elasticsearch_exporter:v1.5.0
fluent-bit-aggregator aura-system devopstf.azurecr.io/tools/fluent-bit:1.7.7
grafana aura-system devopstf.azurecr.io/tools/grafana:8.3.4
kibana-kb aura-system docker.elastic.co/kibana/kibana:8.7.0
prometheus aura-system devopstf.azurecr.io/tools/prom/prometheus:v2.32.1
mongodb aura-system devopstf.azurecr.io/tools/mongo:4.4.18
mongodb-atlas-operator aura-system devopstf.azurecr.io/tools/mongodb-atlas-kubernetes-operator:1.5.1
redis-exporter aura-system devopstf.azurecr.io/tools/redis-exporter:1.6.1
redis aura-system devopstf.azurecr.io/tools/redis:6.0.19
thanos-store-gateway aura-system devopstf.azurecr.io/tools/thanos:v0.24.0
atlas-logger aura-system devopstf.azurecr.io/tools/atlas-logger:1.0.0
azure-logger aura-system devopstf.azurecr.io/tools/azure-logger:1.3.1
pushgateway aura-system devopstf.azurecr.io/tools/pushgateway:v1.4.1
thanos-querier aura-system devopstf.azurecr.io/tools/thanos:v0.24.0

Additional information

Information regarding Aura system components end-of-life (EOL) and next updates is included in the document Scheduled updates in Aura components. Find it in the Aura releases section of your corresponding release.

1.2 - Aura Authentication API changelog

Aura Authentication API changelog

Changelog of Aura Authentication API component for Vortex Aura Platform release

Changed

2023-11-08 - Refactor in Aura authentication API

  • The component aura-authentication-api has been refactored for more readable and maintainable code.
  • Affected documents:

1.3 - Aura bot changelog

Aura Bot changelog

Changelog of Aura bot component for Vortex Aura Platform release.

Fixed

2023-08-12 - Anonymous user cache management

2023-09-05 - Fix how anonymous users information is refreshed in aura-bot (Vortex 8.2.1.)

  • Anonymous users information is refreshed when the user is authenticated or when she logs out. The timestamp validation between the remote cache (the conversational bot cache) and the user data cached locally has been fixed.

1.4 - Aura Bot Common changelog

Aura Bot Common changelog

Changelog of Aura Bot Common component for Vortex Aura Platform release

Deprecated

2023-03-08 - Aura Bot Common internal crypto-adapter solution marked as deprecated

  • The internal crypto-adapter utility available in Aura Bot Common until U2 release, has been removed. Currently, the solution being exported is the one implemented in aura-crypto-adapter utility , although it is marked as deprecated, because it is expected not to be used, but using directly the already mentioned new utility.

  • The crypto-adapter should be imported from aura-utilities.

1.5 - Aura bridge changelog

Aura bridge changelog

Changelog of Aura bridge component for Vortex release.

Added

2023-07-12 - Added aura-bridge event service

  • A new service is added to aura-bridge: AuraBridgeEventService, in charge of centralizing event management in the different bridge plugins.
  • Affected documents:

2023-07-12 - New event emitted by whatsapp-incoming-processor plugin

  • whatsapp-incoming-processor plugin will now send a whatsapp.ackMessageReceived event when an ACK message is received from WhatsApp.

Changed

2023-07-26 - Description of new parameter messageId

  • New optional parameter messageId is added in async-callback API. This is optional, but with redis cache, it is needed to keep the structure of the messages.
  • Affected documents:

2023-08-11 - Add new metrics in aura-bridge

  • A new incoming_message_duration_seconds metric has been included.
  • Affected documents:

2023-08-21 - Using Redis to manage the message queue

  • MongoDB has been replaced by Redis for the management of messages that need to use the Queue.
  • Affected documents:

Deprecated

2023-08-21 - Using MongoDB in the Bridge in Queue Manager

  • The use of MongoDB in the Bridge for queue management has been deprecated.

1.6 - Aura groot changelog

Aura groot changelog

Changelog of Aura groot component for Vortex Aura Platform release

Added

2023-09-05 - Add new internal endpoints to access heap memory in aura-groot (Vortex 8.2.1.)

  • Two new endpoints have been published to access heap memory in aura-groot:
    • /heapSnapshot endpoint, that must be called internally directly accessing to the aura-groot pod. It stores in Aura Azure Storage Account a copy of the heap memory of the pod. It is useful to debug memory leaks.
    • /heapStatistics endpoint, that must be called internally directly accessing to the aura-groot. It returns the heap memory statistics of the pod.
  • Affected documents:

Changed

2023-08-11 - Add new metrics in aura-groot

  • A new http_request_duration_seconds metric has been included.
  • A new outgoing_request_duration_seconds metric has been included.
  • A new outgoing_message_duration_seconds metric has been included.
  • A new incoming_message_duration_seconds metric has been included.
  • A new aura_component_version metric has been included.
  • A new aura_server_unhandled_error metric has been included.
  • A new skill_access_error metric has been included.
  • A new skill_request_status metric has been included.
  • A new skill_response_error metric has been included.
  • Affected documents:

2023-09-05 - Changed fields written by aura-groot in USER KPI entity files (Vortex 8.2.1.)

Modifications in aura-groot behavior in order to improve its performance and reduce the number of calls to aura-authentication-api for anonymous users to write KPIs information:

  • aura-groot now only writes certain fields (USER_ID, PHONE_ID, AURA_ID_GLOBAL) if the request is done with channelData V1 or V2 and the channel does not support anonymous users.
  • In any other case, aura-groot writes only the AURA_ID of the user. To be able to obtain all the information from a user, it is necessary to cross the data written by aura-groot and aura-bot.

Fixed

2023-09-05 - Fix memory handling in aura-groot (Vortex 8.2.1.)

Optimization of aura-groot memory handling, with the following changes:

  • Removed whole skill configuration object from conversational context. Only its identifier is maintained.
  • Reviewed when conversation state is stored to reduce the number of accesses to the conversational context database.
  • Removed active skill identifier object from conversation context when the conversation with the skill ends.

1.7 - Aura utilities changelog

Aura utilities changelog

Changelog of Aura utilities component for this Aura Platform release

Added

2023-03-08 - Add crypto-adapter utility

  • aura-crypto-adapter utility is added to provide methods for encrypting and decrypting data.

  • The crypto-adapter utility was added here to replace all other already existing implementations across Aura repeating the same code in different projects to handle encryption and decryption. This has been a task of cleaning and reusing code, to make it easier to maintain.

  • Affected documents:

1.8 - Aura Release Train Manager changelog

Added

2023-08-10 Added Aura Release Train Manager API definition

1.9 - Aura documentation changelog

Aura documentation changelog

Changelog of Aura Documentation for Vortex Aura Platform release

The current section:

✅ Includes changes that exclusively affect to the improvement of Aura documentation (generation of new documents, writing style, structure, format, fixing typos, etc.)

⛔ Does not include technical corrections in documents or modifications derived from changes over a specific Aura component. These ones will be included in their corresponding section within the release changelog.

Added

  • The guidelines related to building generic questions experiences have been updated, firstly restructuring the documents in two main blocks:
  • Affected documents:

2023-08-25 - Improved Aura distributed architecture documentation

  • Based on the Phase 1 of Aura distributed architecture, implemented in U2 release, the generated documentation to understand the new Aura ecosystem has been improved and completed:
    • Added aura-groot database and new environment variables documentation.
    • Generated an updated flowchart for Aura conversational process, including aura-groot interactions.
    • Review aura-groot middlewares documentation.
    • Created guidelines for adding a skill to aura-minigroot for its testing.
    • Other enhancements and fixes.
  • Affected documents:

Changed

2023-08-28 - Documents fixes and corrections

Throughout the website, different links, styles and typos have been corrected, for a continuous improvement of Aura Platform documentation.

2 - Scheduled updates in Aura components

Scheduled updates in Aura components

List of basic dependencies used by Aura components with their EOL information and the maximum frequency of update proposed by Aura Global team to avoid security issues. It also contains the next scheduled update, if it is already known.

Future updates

Aura Component Dependency Current Version EOL Max frequency Next update EOL Info
Aura System aks/kubernetes 1.26 03/24 Twice a year 2023Q4 https://learn.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#kubernetes-versions
Aura System elasticsearch 8.7.0 10/08/24 Once a year 2023Q4 https://www.elastic.co/es/support/eol
Aura System grafana 8.3.4 N/A Once a year 2023Q4 https://community.grafana.com/t/support-policy-for-previous-releases/53350
Aura System kibana 8.7.0 10/08/24 Once a year 2023Q4 https://www.elastic.co/es/support/eol
Aura System prometheus 2.32.1 N/A Once a year 2023Q4 https://prometheus.io/docs/introduction/release-cycle/
Aura System, Aura Bot mongodb 4.4 02/24 Once a year 2023Q4 https://www.mongodb.com/support-policy/lifecycles
Aura System, Aura Bot node docker image node:18.16.0-alpine3.17 11/24 Once a year 2024Q2 https://endoflife.date/alpine
Aura System, Aura Context redis 6.0 N/A Once a year 2024Q1 https://endoflife.date/redis
Aura Bot nodejs 18.16.0 04/24 Once a year 2024Q2 https://endoflife.date/nodejs
Aura Bot typescript 5.0.0 12/24 Once a year 2024Q2
Aura Bot botbuilder 4.19.6 N/A Once a year 2024Q2
Aura Bot joi 17.6.0 N/A Once a year 2024Q2
Aura Bot superagent 8.0.5 N/A Once a year 2024Q2
QA Tool python 3.8/3.9 14/10/24 (3.8) Once a year 2024Q3 https://endoflife.date/python

3 - Vortex Release Notes

Vortex Release Notes