Vortex release changelog

• 1: Aura system components version
• 2: Aura Authentication API changelog
• 3: Aura bot changelog
• 4: Aura Bot Common changelog
• 5: Aura bridge changelog
• 6: Aura groot changelog
• 7: Aura utilities changelog
• 8: Aura Release Train Manager changelog
• 9: Aura documentation changelog

1 - Aura system components version

Aura system components versions

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.

2 - Aura Authentication API changelog

Aura Authentication API changelog

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:
  • aura-authentication-api

3 - Aura bot changelog

Aura Bot changelog

Fixed

2023-08-12 - Anonymous user cache management

• Cache management for anonymous users has been fixed.
• Affected documents:
  • Aura Users Cache Expire

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.

4 - Aura Bot Common changelog

Aura Bot Common changelog

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.

5 - Aura bridge changelog

Aura bridge changelog

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:
  • Aura bridge events management

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:
  • Auraline channel callback API

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

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

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:
  • Message Synchronization

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.

6 - Aura groot changelog

Aura groot changelog

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:
  • Aura groot endpoints

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:
  • Aura groot metrics

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.

7 - Aura utilities changelog

Aura utilities changelog

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:

  • aura-crypto-adapter utility

8 - Aura Release Train Manager changelog

Added

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

• Added the first version of the Aura Release Train Manager API definition.
• Affected documents:
  • Aura Release Train Manager API

9 - Aura documentation changelog

Aura documentation 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:
  • Aura distributed architecture
    Introduction to the new architecture: functional overview, operation at a glance and functional description of the implementation phases.
    Documents suitable for business managers and less skilled technical profiles.
  • Aura Bot service
    Technical descriptive documentation regarding Aura’s development architecture and its key components.
    Documents suitable for Aura technical teams.
    • Aura conversational process flowchart
    • Aura Groot databases
    • Aura Groot environment variables
    • Aura Groot middlewares
  • Manage skills
    Practical guidelines for the development of skills and the connection of a skill to aura-groot.
    Documents suitable for Aura technical teams.
    • Guidelines for the connection of a skill to Aura Minigroot

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.