You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Use environment variables with the Reporting CLI
Instead of explicitly providing values in the command line, you can save them as environment variables. The Reporting CLI reads environment variables from the current directory inside the project.
To set the environment variables in Linux, use the following command:
export NAME=VALUE
Each line should use the format NAME=VALUE
. Each line that starts with a hashtag (#) is considered to be a comment. Quotation marks (“) don’t get any special handling.
Values from the command line argument have higher priority than the environment file. For example, if you add the file name as test in the .env file and also add the --filename report
command option, the generated report’s name will be report.
Example: Requesting a PNG report with environment variables set
The following command requests a report with basic authentication in PNG format:
opensearch-reporting-cli --url https://localhost:5601/app/dashboards#/view/7adfa750-4c81-11e8-b3d7-01146121b73d --format png --auth basic --credentials admin:<custom-admin-password>
Upon success, the report will download to the current directory.
Using Amazon SES to request an email with a report attachment
To use Amazon SES as the email transport mechanism, the following prerequisites apply:
- The sender’s email address must be verified by Amazon SES. The AWS Command Line Interface (AWS CLI) is required to interact with Amazon SES. To configure basic settings used by the AWS CLI, see Quick configuration with
aws configure
in the AWS Command Line Interface user guide. - Amazon SES transport requires the
ses:SendRawEmail
role:
{
"Statement": [
{
"Effect": "Allow",
"Action": "ses:SendRawEmail",
"Resource": "*"
}
]
}
The following command requests an email with the report attached:
opensearch-reporting-cli --url https://localhost:5601/app/dashboards#/view/7adfa750-4c81-11e8-b3d7-01146121b73d --transport ses --from <sender_email_id> --to <recipient_email_id>
The following command uses default values for all other options. You can also set OPENSEARCH_FROM
, OPENSEARCH_TO
, and OPENSEARCH_TRANSPORT
in your .env file and use the following command:
opensearch-reporting-cli --url https://localhost:5601/app/dashboards#/view/7adfa750-4c81-11e8-b3d7-01146121b73d
To modify the body of your email, you can edit the index.hbs file.
Example: Sending a report to an email address with SMTP
To send a report to an email address with SMTP transport, you need to set the options OPENSEARCH_SMTP_HOST
, OPENSEARCH_SMTP_PORT
, OPENSEARCH_SMTP_USER
, OPENSEARCH_SMTP_PASSWORD
, and OPENSEARCH_SMTP_SECURE
in your .env file.
Once the transport options are set in your .env file, you can send the email using the following command:
opensearch-reporting-cli --url https://localhost:5601/app/dashboards#/view/7adfa750-4c81-11e8-b3d7-01146121b73d --transport smtp --from <sender_email_id> --to <recipient_email_id>
You can choose to set options using either your .env file or the command line argument values in any combination. Make sure to specify all required values to avoid errors.
To modify the body of your email, you can edit the index.hbs file.
Limitations
The following limitations apply to environment variable usage with the Reporting CLI:
-
Supported platforms are Windows x86, Windows x64, Mac Intel, Mac ARM, Linux x86, and Linux x64.
For any other platform, users can take advantage of the CHROMIUM_PATH environment variable to use custom Chromium.
-
If a URL contains an exclamation point (!), then the history expansion needs to be disabled temporarily. Depending on which shell you are using, you can disable history expansion using one of the following commands:
- For bash, use
set +H
. - For zsh, use
setopt nobanghist
.
Alternatively, you can add a URL value as an environment variable using this format:
URL="<url-with-!>"
. - For bash, use
-
All command options only accept lowercase letters.
Troubleshooting
To resolve MessageRejected: Email address is not verified, see Why am I getting a 400 “message rejected” error with the message “Email address is not verified” from Amazon SES? in the AWS Knowledge Center.