Aura –

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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/

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Aura logging utility

Docs: Aura deployment changelog

Mon, 01 Jan 0001 00:00:00 +0000

Changed

2023-07-12 - Updated Nginx version to 1.25.1

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

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Aura Bot service
- Aura Groot

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:
- Aura KPI entities

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Aura KPIs Uploader

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:
- Aura KPIs Uploader

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.

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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.

Affected documents:
- Generic Dialog V1
- Configuration API Swagger

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:
- generic-dialog-v3
- TV content get info dialog v3

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:
- Aura Mini Bot

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:
- Aura logging utility

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:
- file-manager recognizer

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:
- Aura Mini Bot

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/"
}

Affected documents:
- Aura Bot environment variables

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Current channel configuration

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- TV content get info plugin

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Aura logging utility

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- aura-bot-kpis-utility

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:
- aura-minibot-service-utility

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:
- skill-configuration-utility

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- skill-module

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:
- Aura logging utility

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- File Manager API

Docs:

Mon, 01 Jan 0001 00:00:00 +0000

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:
- Aura Bot architecture
- incoming-event-middleware

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.

Aura –

Docs:

Aura system components versions

AKS versions

Statefulsets

Deployments

EOL

Docs:

Aura bridge changelog

Changed

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

Docs: Aura deployment changelog

Changed

2023-07-12 - Updated Nginx version to 1.25.1

Docs:

Aura Groot changelog

Added

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

2023-07-18 - KPI entities are written

Docs:

Aura KPIs Uploader changelog

Added

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

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

Fixed

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

Docs:

Aura Bot changelog

Added

2023-06-27 - Deterministic FAQ answers

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

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

Changed

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

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

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

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

Fixed

2023-07-18 - Prometheus HTTP request metrics aggregation

Docs:

Aura Channels changelog

Added

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

Docs:

Aura Complex Logic Framework changelog

Added

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

Docs:

Aura Authentication API changelog

Changed

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

Docs:

Aura Utilities changelog

Added

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

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

Changed

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

Docs:

Aura Configuration API changelog

Added

2022-07-19 - Endpoints to manage skills configuration

Changed

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

Docs:

Aura file manager changelog

Changed

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

Docs:

Aura documentation changelog

Added

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

Changed

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

2023-07-17 - Documents fixes and corrections

Deleted

2023-07-17 - Deleted document related to releases previous to Killers

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