Composer v7.0 Enhancements
This topic provides details about the enhancements in Composer 7.0.
- Amazon Web Services (AWS) Authentication Support for Elasticsearch Connectors
- Arc Gauge Updates
- KPI Chart Updates
- Custom Metric Date and Time Aggregation Function Changes
- New Custom Metric Filter Operators
- Dashboard Import Changes
Support for authentication with Amazon Web Services (AWS) credentials was added to the Composer Elasticsearch 6 and Elasticsearch 7 connectors in this release. AWS credentials are specified in a standard AWS-format credentials file (see Format of the credentials file) and stored in the Elasticsearch connector’s file system. After connecting, the Composer Elasticsearch connectors work with AWS Elasticsearch without any restrictions.
A new configuration property
elasticsearch.aws.show-aws-connection-params and four new connection parameters have been added to the Composer Elasticsearch connectors to allow users to control authentication using AWS credentials.
elasticsearch.aws.show-aws-connection-paramsproperty specifies whether AWS-specific connection parameters should be shown when a new connector is created or the connection properties of an existing connector are refreshed. Valid values are
false. The default is
false(users will not see new AWS connection parameters).
AUTHENTICATE_WITH_AWS_CREDENTIALSconnection parameter indicates whether authentication with AWS credentials should be used. Note that the Elasticsearch username / password specification and AWS credentials cannot be simultaneously used for authentication. Valid values are
false. The default is
false(AWS authentication will not be used).
AWS_REGIONconnection parameter is a string parameter used to specify the AWS region where the target Elasticsearch service is running. This parameter is optional when host names in the connection string have the standard format
<domain>.<region>.es.amazonaws.com(the region name can be extracted from the host name). However, when specified, it has priority over the region name included in the host name.
AWS_PROFILES_CONFIG_PATHconnection parameter is a string parameter used to specify the location of the AWS credentials file in the Elasticsearch connector’s file system. This parameter is optional when the credentials file is in the default location (
~/.aws/credentialsfor the user of the connector).
AWS_PROFILEconnection parameter is a string parameter used to specify the profile to use within the AWS credentials file. This parameter is optional if you choose to use the default profile.
For complete information, see Connect to Elasticsearch Using Amazon Web Services Authentication.
The Show label description and Show as percentage switches no longer appear on the Rulers sidebar for the gauge.
The Show label description switch is now located on the Settings sidebar for the gauge. See Display Arc Gauge Label Description.
The Show as percentage switch for the arc metric is now located on the Settings sidebar for the gauge and has been renamed Show Values As and provides two options: Absolute and Relative.
Select Absolute to display values as the actual raw values.
Select Relative to display values as percentages.
The Show as percentage switch for the color metric for the gauge has been moved to the Colors sidebar for the gauge and has been renamed Thresholds in Percentage. It only appears when the Threshold Mode is set to Manual. Turn on Thresholds in Percentage to set color thresholds using percentages rather than raw values. See Configure Colors for a Specific Arc Gauge.
See Arc Gauges.
You can now apply color formatting thresholds to the background color of a KPI chart. The default is to apply the color formatting thresholds to the displayed KPI chart value. A new Apply Formatting To setting is provided in the Color sidebar for KPI chart and in the data source KPI chart defaults. Valid values for the setting are Metric or Background.
Select Metric to apply color threshold formatting to the displayed KPI chart value.
Select Background to apply color threshold formatting to the KPI chart background.
See KPI Charts.
Custom metrics now support the
time_add functions used by row-level expressions. The original custom metric
DateSUB functions still work but should no longer be used. They are deprecated in this release and will be removed in a future release. Instead, use the
The following table provides examples of how the original functions can be replaced by the
|Original Function Specification||New Function Specification|
Five new custom metric filter operators have been added: IS NULL, IS NOT NULL, STARTS WITH, ENDS WITH, and CONTAINS. All of these operators can be used to filter attributes. Values supplied in WHERE clauses in reference to STARTS WITH, ENDS WITH, or CONTAINS are case-sensitive.
For more information, see Apply Filters to Custom Metrics.
You can now use the API to import a dashboard using a new overwrite policy, so that dashboards with the same name are overwritten instead of being imported with a slightly altered name. A new query parameter,
strategy, has been added for the
POST /api/dashboards/import endpoint. Valid values can be
OVERWRITEto implement the new overwrite policy.
USE_EXISTING_OR_CREATEto continue to use the existing import policy (importing the dashboard with a slightly altered name). This is the default value and will be used if
strategyis not specified.
For more information about requesting the overwrite policy and its behavior, see Overwrite Policy Behavior.