Skip to main content

cdk8s-grafana

View on Construct Hub

cdk8s-grafana is a library that lets you easily define a Grafana service for your kubernetes cluster along with associated dashboards and datasources, using a high level API.

Usage

To apply the resources generated by this construct, the Grafana operator must be installed on your cluster. See https://operatorhub.io/operator/grafana-operator for full installation instructions.

The following will define a Grafana cluster connected to a Prometheus datasource:

import { Grafana } from 'cdk8s-grafana';

// inside your chart:
const grafana = new Grafana(this, 'my-grafana', {
  defaultDataSource: {
    name: 'Prometheus',
    type: 'prometheus',
    access: 'proxy',
    url: 'http://prometheus-service:9090',
  }
});

Basic aspects of a dashboard can be customized:

const github = grafana.addDatasource('github', ...);
const dashboard = grafana.addDashboard('my-dashboard', {
  title: 'My Dashboard',
  refreshRate: Duration.seconds(10),
  timeRange: Duration.hours(6), // show metrics from now-6h to now
  plugins: [
    {
      name: 'grafana-piechart-panel',
      version: '1.3.6',
    }
  ],
});

Note: the kubernetes grafana operator only supports one Grafana instance per namespace (see https://github.com/grafana-operator/grafana-operator/issues/174). This may require specifying namespaces explicitly, e.g.:

const devGrafana = new Grafana(this, 'my-grafana', {
  namespace: 'dev',
});
const prodGrafana = new Grafana(this, 'my-grafana', {
  namespace: 'prod',
});

The grafana operator must be installed in each namespace for the resources in that namespace to be recognized.

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cdk8s_grafana-0.1.791.tar.gz (327.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cdk8s_grafana-0.1.791-py3-none-any.whl (325.9 kB view details)

Uploaded Python 3

File details

Details for the file cdk8s_grafana-0.1.791.tar.gz.

File metadata

  • Download URL: cdk8s_grafana-0.1.791.tar.gz
  • Upload date:
  • Size: 327.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.14.6

File hashes

Hashes for cdk8s_grafana-0.1.791.tar.gz
Algorithm Hash digest
SHA256 91d24f84b79f774c59a9da2eaecaa3182e44cfb22fa24e10b87d8d0cee1829d0
MD5 445f761018d1f0f8c9192010f6b454da
BLAKE2b-256 d169e73de2bb2f0221a8ae21985e2ef5404908eee1108d4c6d46d0a2168ecc09

See more details on using hashes here.

Provenance

The following attestation bundles were made for cdk8s_grafana-0.1.791.tar.gz:

Publisher: release.yml on cdk8s-team/cdk8s-grafana

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cdk8s_grafana-0.1.791-py3-none-any.whl.

File metadata

  • Download URL: cdk8s_grafana-0.1.791-py3-none-any.whl
  • Upload date:
  • Size: 325.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.14.6

File hashes

Hashes for cdk8s_grafana-0.1.791-py3-none-any.whl
Algorithm Hash digest
SHA256 fbf82d6f0e0f161c864e23f94bba4435126e1eea1827557a6aab8f96763085b2
MD5 dab2e922fbb987b1028a199382d02bc6
BLAKE2b-256 0b031a8677c49b3e86e52a4f9f25e856433e94781663913385abefe1aa89c03f

See more details on using hashes here.

Provenance

The following attestation bundles were made for cdk8s_grafana-0.1.791-py3-none-any.whl:

Publisher: release.yml on cdk8s-team/cdk8s-grafana

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page