TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

New Relic Open Source community project banner.

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.


npm install @newrelic/cdk-dashboards


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


See API.md


Build with projen, see this tutorial to get started.

npx projen build


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


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:



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.


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.

Package Sidebar


npm i @newrelic/cdk-dashboards

Weekly Downloads






Unpacked Size

3.08 MB

Total Files


Last publish


  • newrelic