CDK Dashboards

AWS CDK Level 2 Constructs for New Relic Dashboards via the NerdGraph Graphql API.

This TypeScript code is JSII compatible and can be cross compiled to any JSII supported language.

Installation

npm install @newrelic/cdk-dashboards

Use

Create Dashboard

dm = new DashboardManager(stack, 'testing-stack', { key: TestConfiguration.LicenseKey });
dashboardInput = {
  permissions: 'PUBLIC_READ_WRITE',
  description: 'L2 CDK Dashboard Create Test',
  name: 'L2DashboardCreate',
  pages: [{
    description: 'Page Description',
    name: 'Page Name',
    widgets: [{ title: 'Widget Title', configuration: { markdown: { text: 'Markdown text' } } }],
  }],
};
const result = await dm.create( 1074083, dashboardInput );

Update Dashboard

Delete Dashboard

Read Dashboard

List Dashboards

Documentation

See API.md

Building

Build with projen, see this tutorial to get started.

npx projen build

Testing

Test with Jest. Configure your New Relic License key in local/setupJest.ts like this

export class TestConfiguration {
   public static LicenseKey: string = 'YOUR_NEWRELIC_LICENSE_KEY_HERE';
}

npx projen test

Support

New Relic hosts and moderates an online forum where you can interact with New Relic employees as well as other customers to get help and share best practices. Like all official New Relic open source projects, there's a related Community topic in the New Relic Explorers Hub. You can find this project's topic/threads here:

https://forum.newrelic.com/

Contribute

We encourage your contributions to improve CDK L2 Dashboards! Keep in mind that when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project.

If you have any questions, or to execute our corporate CLA (which is required if your contribution is on behalf of a company), drop us an email at opensource@newrelic.com.

A note about vulnerabilities

As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.

If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.

If you would like to contribute to this project, review these guidelines.

To all contributors, we thank you! Without your contribution, this project would not be what it is today. We also host a community project page dedicated to CDK L2 Dashboards.

License

CDK L2 Dashboards is licensed under the Apache 2.0 License. The CDK L2 Dashboards also uses source code from third-party libraries. You can find full details on which libraries are used and the terms under which they are licensed in the third-party notices document.