Alice Williams
1dd560977b
* add files back from lost local files Signed-off-by: Alice Williams <[email protected]> * nest reporting CLI under main Reporting page Signed-off-by: Alice Williams <[email protected]> * rough draft examples for AWS Lambda and Cron Signed-off-by: Alice Williams <[email protected]> * better title for cron job report example Signed-off-by: Alice Williams <[email protected]> * for more details from tech reviewer Signed-off-by: Alice Williams <[email protected]> * for better cron job usage description Signed-off-by: Alice Williams <[email protected]> * for more details Signed-off-by: Alice Williams <[email protected]> * remove needs info markers and add links to events doc Signed-off-by: Alice Williams <[email protected]> * more info Signed-off-by: Alice Williams <[email protected]> * more details from demonstration Signed-off-by: Alice Williams <[email protected]> * remove reporting directory to keep both parallel in left nav Signed-off-by: Alice Williams <[email protected]> * small addition Signed-off-by: Alice Williams <[email protected]> * for two configuration settings in the function Signed-off-by: Alice Williams <[email protected]> * more details from eng meeting adding to the steps Signed-off-by: Alice Williams <[email protected]> * more details from eng meeting adding to the steps Signed-off-by: Alice Williams <[email protected]> * for more details Signed-off-by: Alice Williams <[email protected]> * for additional steps to create and test the lambda function Signed-off-by: Alice Williams <[email protected]> * for scheduling reports with lambda Signed-off-by: Alice Williams <[email protected]> * merge redundant set of steps together Signed-off-by: Alice Williams <[email protected]> * for tech review comments Signed-off-by: Alice Williams <[email protected]> * to add download correct title and link Signed-off-by: Alice Williams <[email protected]> * for reporting directory to nest new cli page Signed-off-by: Alice Williams <[email protected]> * un-nest reporting directory Signed-off-by: Alice Williams <[email protected]> * to remove reporting directory - will nest with other page in separate PR Signed-off-by: Alice Williams <[email protected]> * tech review comments and some reorg Signed-off-by: Alice Williams <[email protected]> * for tech review comments Signed-off-by: Alice Williams <[email protected]> * to minor changes Signed-off-by: Alice Williams <[email protected]> * more info about crontab sequence Signed-off-by: Alice Williams <[email protected]> * cron updates Signed-off-by: Alice Williams <[email protected]> * for cron syntax Signed-off-by: Alice Williams <[email protected]> * small updates to lambda proc Signed-off-by: Alice Williams <[email protected]> * for final writer checklist Signed-off-by: Alice Williams <[email protected]> * cron link update Signed-off-by: Alice Williams <[email protected]> * format fix Signed-off-by: Alice Williams <[email protected]> * for doc review cron & lambda sections Signed-off-by: Alice Williams <[email protected]> * for cron reference to man page Signed-off-by: Alice Williams <[email protected]> * add internal link to cron ref Signed-off-by: Alice Williams <[email protected]> * reorg single topic into 7 pages Signed-off-by: Alice Williams <[email protected]> * minor update Signed-off-by: Alice Williams <[email protected]> * link to set ses permissions Signed-off-by: Alice Williams <[email protected]> * for tech review meeting updates Signed-off-by: Alice Williams <[email protected]> * small update Signed-off-by: Alice Williams <[email protected]> * npm download command name changed to remove opensearch prepended name Signed-off-by: Alice Williams <[email protected]> * for new download via artifacts hub Signed-off-by: Alice Williams <[email protected]> * for new download instructions Signed-off-by: Alice Williams <[email protected]> * small fix signature file Signed-off-by: Alice Williams <[email protected]> * typo Signed-off-by: Alice Williams <[email protected]> * for cleaner image Signed-off-by: Alice Williams <[email protected]> * remove image for push commands we won't use Signed-off-by: Alice Williams <[email protected]> --------- Signed-off-by: Alice Williams <[email protected]>
3.1 KiB
layout, title, nav_order, parent
| layout | title | nav_order | parent |
|---|---|---|---|
| default | Reporting CLI options | 30 | Creating reports with the Reporting CLI |
Reporting CLI options
You can use any of the following arguments with the opensearch-reporting-cli tool.
| Argument | Description | Acceptable values and usage | Environment variable
:--------------------- | :--- | :--- |
-u, --url | The URL for the visualization. | Obtain from OpenSearch Dashboards > Visualize > Share > Permalinks > Copy link. | OPENSEARCH_URL
-a, --auth | The authentication type for the report. | You can specify either Basic basic, Cognito cognito, SAML saml, or No Auth none. If no value is specified, the Reporting CLI tool defaults to no authentication, type none. Basic, Cognito, and SAML require credentials with the -c flag. | N/A
-c, --credentials | The OpenSearch login credentials. | Enter your username and password separated by a colon. For example, username:password. Required for Basic, Cognito, and SAML authentication types. | OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD
-t, --tenant | The tenants in OpenSearch Dashboards. | The default tenant is private.| N/A
-f, --format | The file format for the report. | Can be either pdf, png, or csv. The default is pdf.| N/A
-w, --width | The window width in pixels for the report. | Default is 1680.| N/A
-l, --height | The minimum window height in pixels for the report. | Default is 600. | N/A
-n, --filename | The file name of the report. | Default is reporting. | opensearch-report-YYY-MM-DDTHH-mm-ss.sssZ
-e, --transport | The transport mechanism for sending the email. | For Amazon SES, specify ses. Amazon SES requires an AWS configuration on your system to store the credentials. For SMTP, use smtp and also specify the login credentials with --smtpusername and --smtppassword. | OPENSEARCH_TRANSPORT
-s, --from | The email address of the sender. | For example, [email protected]. | OPENSEARCH_FROM
-r, --to | The email address of the recipient. | For example, [email protected]. | OPENSEARCH_TO
--smtphost | The hostname of the SMTP server. | For example, SMTP_HOST. | OPENSEARCH_SMTP_HOST
--smtpport | The port for the SMTP connection. | For example, SMTP_PORT. | OPENSEARCH_SMTP_PORT
--smtpsecure | Specifies to use TLS when connecting to the server. | For example, SMTP_SECURE. | OPENSEARCH_SMTP_SECURE
--smtpusername | The SMTP username.| For example, SMTP_USERNAME. | OPENSEARCH_SMTP_USERNAME
--smtppassword | The SMTP password.| For example, SMTP_PASSWORD. | OPENSEARCH_SMTP_PASSWORD
--subject | The email subject text encased in quotes. | Can be any string. The default is "This is an email containing your dashboard report". | OPENSEARCH_EMAIL_SUBJECT
--note | The email body, either a string or a path to a text file. | The default note is "Hi,\nHere is the latest report!" | OPENSEARCH_EMAIL_NOTE
-h, --help | Specifies to display the list of optional arguments from the command line. | N/A
Getting help
To get a list of all available CLI arguments, run the following command:
$ opensearch-reporting-cli -h