aws-cloudwatch-annotations's Introduction

aws-cloudwatch-annotations

Annotate Cloudwatch dashboards with horizontal/vertical annotations

Install

$ npm install --global aws-cloudwatch-annotations

Usage

$ aws-cloudwatch-annotations help
Usage:
    aws-cloudwatch-annotations dashboard_name
Options:
    --fill, -f              Fill value for annotation (before/after/between)
    --color, -c             Annotation color
    --widget-title, -w      Update only widgets whose title matching specified regex
    --limit, -l             Max number of annotations to maintain
    --title, -t             Annotation title. Default: 'Deployment'
    --value, -v             Annotation value. Default: Current time
    --horizontal, -h        Add horizontal annotation instead of vertical (default)

Initial setup for AWS credentials available via environment variables or via the shared credentials file is necessary. Please look at AWS credentials documentation for details.

If aws-cloudwatch-annotations is run on an EC2 instance add the following permissions to the instance role. Adapt it with the correct AWS account ID and dashboard name(s).

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutDashboard",
                "cloudwatch:GetDashboard"
            ],
            "Resource": [
                "arn:aws:cloudwatch::123456789123:dashboard/annotations"
            ]
        }
    ]
}

Examples

# Vertical annotation between two timestamps
aws-cloudwatch-annotations api-metrics --widget-title annotations --title 'Deployment #42' --value '2018-08-28T11:56:47Z' --upto '2018-08-29T11:59:47Z'

# Vertical annotation at a single timestamp
aws-cloudwatch-annotations api-metrics --widget-title annotations --title 'Enable feature toggle' --value '2018-08-28T11:56:47Z'

aws-cloudwatch-annotations's People

Contributors

Stargazers

Watchers

aws-cloudwatch-annotations's Issues

Import error

For the last couple of days we've been getting the below import error:

file:///Documents/node_modules/aws-cloudwatch-annotations/lib/cloudwatch.js:1
import { CloudWatchClient, GetDashboardCommand, PutDashboardCommand } from "@aws-sdk/client-cloudwatch";
         ^^^^^^^^^^^^^^^^
SyntaxError: Named export 'CloudWatchClient' not found. The requested module '@aws-sdk/client-cloudwatch' is a CommonJS module, which may not support all module.exports as named exports.
CommonJS modules can always be imported via the default export, for example using:

import pkg from '@aws-sdk/client-cloudwatch';
const { CloudWatchClient, GetDashboardCommand, PutDashboardCommand } = pkg;

    at ModuleJob._instantiate (node:internal/modules/esm/module_job:105:21)
    at async ModuleJob.run (node:internal/modules/esm/module_job:151:5)
    at async Loader.import (node:internal/modules/esm/loader:166:24)
    at async Object.loadESM (node:internal/process/esm_loader:68:5)

Recommend Projects