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

Return to the regular view of this page.

U2 Release

U2 release

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

What’s new in U2 (8.1.0)?

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
Review STB and MP Use Cases ✔️ Remove intent.tv.on configuration from set-top-box channel.
✔️ Remove communications domain from set-top-box and movistar-plus channels.
New sentences for the opening of Menu section ✔️ New training sentences added in set-top-box training for the opening of Menu section.
Deterministic FAQ answers ✔️ Obtain deterministic FAQ answers based on dialog configuration
TV content get info use case ✔️ The TV content get info use case is integrated into channelData v3 and, for the current release, includes basic features for asking Aura for information regarding a specific TV channel using a vocal interface
TV content get info CLF plugin ✔️ Added the Complex Logic Framework plugin for TV content get info use case
Added IP origin in public servers ✔️ The field “origin” has been included in the incoming request log for all servers with public access
Added Content-Type field in FileData object ✔️ The Content-Type field is sent from aura-bot to the file-manager, so files can be always stored with a proper extension.
Nginx version 1.25.1. ✔️ Nginx version is upgraded to 1.25.1, in order to rely on a supported version.
Improved Aura Platform documentation ✔️ Aura Technical documentation website is progressively adapted to an improved architecture and structure.
✔️ Documents are continuously updated, reviewed and corrected in order to achieve, release after release, a better quality in Aura Platform documentation.
Skill Configuration API ✔️ Added new endpoints in aura-configuration-api to manage skills configuration
Aura distributed architecture documentation ✔️ Delivery of comprehensive documentation to understand Aura’s new architecture
New component: Aura Groot ✔️ Aura Groot is the main component to handle the distributed architecture of Aura. It is responsible for handling the communication between each channel and its corresponding skill, keeping track of all the communication, but introducing a minimal interference in their communication.
Aura Bot is now a skill ✔️ Aura Bot is no longer a single bot, but a skill, so it depends on aura-groot to provide a full Aura’s request and response handling.
Prometheus HTTP request metrics aggregation ✔️ Added a mechanism based on an environment variable to be able to aggregate path metrics in Prometheus.
CLF KPI entity files are generated ✔️ aura-clf API now generates its own API request KPI files and they are processed and uploaded to Kernel by aura-kpis-uploader.
Aura Mini Groot ✔️ aura-mini-bot development component has been extended with aura-mini-groot so the local tests are kept the same.

1 - U2 release changelog

U2 release changelog

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

Select the Aura component of your interest in the left menu.

1.1 - Aura system components version

Aura system components versions

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

AKS versions

Kubernetes version can be obtained from an already deployed cluster with the following command, reading the information regarding Server version:

$ kubectl version
Client Version: ....
Server Version: version.Info{Major:"1", Minor:"26", GitVersion:"v1.26.3", GitCommit:"9e644106593f3f4aa98f8a84b23db5fa378900bd", GitTreeState:"clean", BuildDate:"2023-03-21T00:12:01Z", GoVersion:"go1.19.7", Compiler:"gc", Platform:"linux/amd64"}
  • Kubernetes version: v1.26.3
  • Nodepools:
    • common: v1.26.3
    • system: v1.26.3
    • management: v1.26.3
    • database: v1.26.3
    • redis: v1.26.3

Statefulsets

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
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
mongodb aura-system devopstf.azurecr.io/tools/mongo:4.4.18
prometheus aura-system devopstf.azurecr.io/tools/prom/prometheus:v2.32.1
redis aura-system devopstf.azurecr.io/tools/redis-exporter:1.6.1
thanos-store-gateway aura-system devopstf.azurecr.io/tools/thanos:v0.24.0

Deployments

Name Namespace Image deployed
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
elasticsearch-exporter aura-system devopstf.azurecr.io/tools/elasticsearch_exporter:v1.5.0
kibana-kb aura-system docker.elastic.co/kibana/kibana:8.7.0
mongodb-atlas-operator aura-system devopstf.azurecr.io/tools/mongodb-atlas-kubernetes-operator:1.5.1
prometheus-msteams aura-system devopstf.azurecr.io/tools/prometheus-msteams:v1.5.0
pushgateway aura-system devopstf.azurecr.io/tools/pushgateway:v1.4.1
thanos-querier aura-system devopstf.azurecr.io/tools/thanos:v0.24.0

EOL

Name Version EOL Info
kubernetes 1.26.3 28/02/24 https://kubernetes.io/releases/#release-history
elasticsearch 8.7.0 10/08/24 https://www.elastic.co/es/support/eol
grafana 8.3.4 N/A https://community.grafana.com/t/support-policy-for-previous-releases/53350
kibana 8.7.0 10/08/24 https://www.elastic.co/es/support/eol
mongodb 4.4 02/2024 https://www.mongodb.com/support-policy/lifecycles
prometheus 2.32.1 N/A https://prometheus.io/docs/introduction/release-cycle/

1.2 - Aura bridge changelog

Aura bridge changelog

Changelog of Aura bridge component for U2 Aura Platform release.

Changed

2023-07-03 - New field origin for incoming request log

  • A new origin field has been included in the incoming request log.
  • Affected documents:

1.3 - Aura deployment changelog

Changelog of Aura deployment process for U2 Aura Platform release

Changed

2023-07-12 - Updated Nginx version to 1.25.1

  • Updated Nginx deployed versions to 1.25.1 to use a supported version.

1.4 - Aura Groot changelog

Aura Groot changelog

Changelog of Aura Groot component for U2 Aura Platform release

Added

2023-07-18 - Aura Groot is a new component

  • Aura Groot is Aura’s implementation of Microsoft BotFramework root bot, i.e. the domain-based orchestrator of Aura’s requests. In this first version, it only applies a domain, that is the channel that originated the request. This means, that every channel can be led to a different skill, so to a different bot. This component is the first access point to Aura, and thus, in charge of validating the requests and responses.
  • All Aura’s features are kept the same, so neither the channels nor the dialogs need to be modified. All the needed changes have been applied in Aura Bot and Aura Groot, to make the transition transparent to the rest of the components.
  • Affected documents:

2023-07-18 - KPI entities are written

  • Aura Groot writes KPI entities to the same Blob Container of the rest of Aura’s components. It writes already existing entities but also some new ones:
    • GROOTMESSAGE: entity to store all the incoming and outgoing messages handled by Aura Groot.
    • USER: entity to store all the users handled by Aura Groot.
    • RECOGNIZER: entity to store all the recognizers handled by Aura Groot. In this version, only an internal recognizer to match each channel with its skill is used, but it is also stored as a recognizer interaction the eventual IntentResult returned by the skill.
  • Affected documents:

1.5 - Aura KPIs Uploader changelog

Aura KPIs Uploader changelog

Changelog of Aura KPIs Uploader component for U2 Aura Platform release

Added

2023-07-18 - Skills are added as a new dimension

  • Skills are now supported as a new dimension in Aura KPIs Uploader. Every time the job is run, the list of configured skills is retrieved from the Aura Configuration API and stored in Kernel Azure Storage, jointly with the list of Channels, Recognizers and LivingApps.
  • Affected documents:

2023-07-18 - Aura Groot KPI entity files are uploaded to Kernel

  • Aura Groot generates its own KPI entity files that are processed and uploaded to Kernel.
  • Affected documents:

Fixed

2023-07-18 - CLF KPI entity files are processed and uploaded to Kernel

  • Aura Complex Logic modules now writes its own API entity files and the files are processed and uploaded to Kernel.

1.6 - Aura Bot changelog

Aura Bot changelog

Changelog of Aura Bot component for U2 Aura Platform release

Added

2023-06-27 - Deterministic FAQ answers

Add getIndexedText function to generic dialog to obtain text resources based on dialogSettings information and entity value.

2023-07-03 - New global dialog to handle normalized TV content get info use case

  • TV content get info use case is available for those channels working in channelData V3. The generic dialog v3, responsible for handling this experience, now includes a specific configuration for it.
  • Affected documents:

2023-07-19 - Provided new repository with the scaffolding of the Aura Mini Bot and Aura Mini Groot

  • A new repository has been published with all the scaffolding needed to use a new Aura Mini Bot and Aura Mini Groot. It contains all the docker utilities and scripts needed to build and deploy the component.
  • Affected documents:

Changed

2023-07-03 - New field origin for incoming request log

  • A new origin field has been included in the incoming request log.
  • Affected documents:

2023-07-07 - Incoming content-type field is sent from aura-bot to file-manager

  • If a user sends a file from a WhatsApp channel to Aura, when it is sent as a document, the extension is not always included in the request, and it must be inferred from the Content-Type sent by WhatsApp in the body of the request. Currently, aura-bot sends the incoming Content-Type in the request to the file-manager, so it can store the file with a proper extension in all the cases.

  • Affected documents:

2023-07-18 - Aura Bot is no longer a single bot but a skill

  • Aura Bot has been converted into a skill to be able to work jointly with Aura Groot. This change implies a lot of modifications regarding who is the first access point to Aura, and thus, in charge of validating the requests and responses. This is now Aura Groot. So, some of the middlewares previously needed by Aura Bot have been moved to Aura Groot.
  • Some of these changes are:
    • Aura Bot is no longer responsible for validating the channelData of the requests and responses.
    • Aura Bridge now communicates with Aura Groot, so Aura Bot does not neeed to handle Aura APIKey header.
  • Affected documents:

2023-07-18 - New version of Aura Mini Bot to work as a skill with Aura Mini Groot

  • A new version of aura-mini-bot has been delivered so it works as a skill and can be used with aura-mini-groot.
  • Affected documents:

Fixed

2023-07-18 - Prometheus HTTP request metrics aggregation

  • Add a mechanism based on an environment variable to be able to aggregate HTTP path metrics in Prometheus.
  • A new environment variable has been added to aura-bot to be able to aggregate HTTP path metrics in Prometheus. This variable is called AURA_PROMETHEUS_REGEX. By default, it contains an empty object, but it can be updated in the config-map of aura-bot to include all APIs that are used by all the dialogs. The variable contains a JSON object with the following structure: a key with the aggregation key to be used in Prometheus and a value with the regular expression to be used to match the path.
{
  "subscribed_products/$1/users/*/products": "/subscribed_products\\\\/(v\\\\d)\\\\/users\\\\/.*\\\\/products/"
}

1.7 - Aura Channels changelog

Aura Channels changelog

Changelog of Aura Channels component for U2 Aura Platform release

Added

2023-06-27 - New setting in channels configuration to modify text resource reference

  • settings.indexedResourceBase has been added to the channel configuration. This setting configures text’s reference to obtain a textual resource.
  • Affected documents:

1.8 - Aura Complex Logic Framework changelog

Aura Complex Logic Framework changelog

Changelog of Aura Complex Logic Framework for U2 Aura Platform release

Added

2023-05-19 - Added TV content get info plugin

  • Generation of a new Complex Logic Framework plugin for the TV content get info use case.
  • Affected documents:

1.9 - Aura Authentication API changelog

Aura Authentication API changelog

Changelog of Aura Authentication API component for U2 Aura Platform release

Changed

2023-07-03 - New field origin for incoming request log

  • A new origin field has been included in the incoming request log.
  • Affected documents:

1.10 - Aura Utilities changelog

Aura Utilities changelog

Changelog of aura-utilities component for U2 Aura Platform release

Added

2022-07-19 - New utility to manage KPI entities in Aura Bot and Aura Groot

  • As Aura Bot and Aura Groot KPI entities handling is pretty similar, a new utility has been created to manage them in both components.
  • Affected documents:

2022-07-19 - New utility to simplify the generation of Aura Mini Bot and Aura Mini Groot

  • As Aura Bot and Aura Groot mini version generation is quite similar, so this new utility has been created to simplify the process, providing all the common elements needed.
  • Affected documents:

Changed

2022-07-19 - Aura Configuration utility is now able to manage skills configuration

  • Added new elements to load skills configuration and make it available for all Aura’s compoenents.
  • Affected documents:

1.11 - Aura Configuration API changelog

Aura Configuration API changelog

Changelog of Aura Configuration API component for U2 Aura Platform release

Added

2022-07-19 - Endpoints to manage skills configuration

  • Added new endpoints to manage skills configuration.
  • Affected documents:

Changed

2023-06-30 - New field origin for incoming request log

  • A new origin field has been included in the incoming request log.
  • Affected documents:

1.12 - Aura file manager changelog

Aura file manager changelog

Changelog of Aura file-manager component for U2 Aura Platform release

Changed

2023-07-04 - file-manager is able to store files with a proper extension in all the cases

  • The new version of the file-manager API includes the content-type field, so it can be used to infer a proper extension to store the file for the cases when the provided URL has no extension.

  • Affected documents:

1.13 - Aura documentation changelog

Aura documentation changelog

Changelog of Aura Documentation for U2 Aura Platform release.

The current section:

✅ Includes changes that exclusively affect to the improvement of Aura documentation (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

2023-07-19 - Delivery of Aura distributed architecture documentation

  • Phase 1 of Aura distributed architecture has been successfully implemented in U2 release. Alongside the development work completed for this phase, Aura Platform Team has generated various documents for readers with varying levels of technical expertise and roles in the project, to understand the new Aura ecosystem: its main functionalities and benefits, operation, key components and practical guidelines.

  • 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.
    • Manage skills Practical guidelines for the development of skills and the connection of a skill to Aura Root. Documents suitable for Aura technical teams.

Changed

2023-07-17 - Moved Aura Bot messages and events information

  • Flowcharts related to aura-bot messages and events were in a wrong location.
  • The diagram showing the messages flow into aura-bot has been moved to the aura-bot architecture section. Moreover, information regarding the different types of activities in the bot is included.
  • Detailed information regarding events is included in the incoming-event-middleware documentation.
  • Affected documents:

2023-07-17 - Documents fixes and corrections

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

Deleted

  • Deleted guidelines for the migration of a use case from releases previous to Killers to this version onwards, as this process is outdated.

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 1.26 06/23 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.19 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.7/3.8/3.9 27/06/23 (3.7) Once a year Vortex https://endoflife.date/python

3 - U2 Release Notes

U2 Release Notes