├── .config
    ├── .eslintrc
    ├── .prettierrc.js
    ├── Dockerfile
    ├── README.md
    ├── jest-setup.js
    ├── jest.config.js
    ├── jest
    │   ├── mocks
    │   │   └── react-inlinesvg.tsx
    │   └── utils.js
    ├── tsconfig.json
    ├── types
    │   └── custom.d.ts
    └── webpack
    │   ├── constants.ts
    │   ├── utils.ts
    │   └── webpack.config.ts
├── .eslintrc
├── .github
    └── workflows
    │   ├── codeql-analysis.yml
    │   ├── pr-tests.yml
    │   └── release.yml
├── .gitignore
├── .prettierrc.js
├── CHANGELOG.md
├── LICENSE
├── Makefile
├── README.md
├── backend
    ├── cassandra
    │   ├── row.go
    │   ├── row_test.go
    │   ├── session.go
    │   └── session_test.go
    ├── go.mod
    ├── go.sum
    ├── handler
    │   ├── data_query.go
    │   ├── data_query_test.go
    │   ├── handler.go
    │   └── handler_test.go
    ├── main.go
    ├── plugin
    │   ├── plugin.go
    │   ├── plugin_test.go
    │   ├── query.go
    │   └── query_test.go
    └── settings.go
├── contributors.md
├── demo
    ├── Dockerfile
    ├── dashboard.json
    ├── docker-compose.yaml
    ├── grafana.db
    └── sample_data.sh
├── docker-compose.yaml
├── jest-setup.js
├── jest.config.js
├── package.json
├── src
    ├── ConfigEditor.tsx
    ├── QueryEditor.tsx
    ├── VariableQueryEditor.tsx
    ├── datasource.ts
    ├── img
    │   ├── cassandra.svg
    │   ├── config.png
    │   ├── configurator.png
    │   ├── editor.png
    │   └── suggestions.png
    ├── models.ts
    ├── module.ts
    └── plugin.json
├── tsconfig.json
└── yarn.lock


/.config/.eslintrc:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in
 5 |  * https://grafana.github.io/plugin-tools/docs/advanced-configuration#extending-the-eslint-config
 6 |  */
 7 |  {
 8 |   "extends": ["@grafana/eslint-config"],
 9 |   "root": true,
10 |   "rules": {
11 |     "react/prop-types": "off"
12 |   }
13 | }
14 | 


--------------------------------------------------------------------------------
/.config/.prettierrc.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in .config/README.md
 5 |  */
 6 | 
 7 | module.exports = {
 8 |   "endOfLine": "auto",
 9 |   "printWidth": 120,
10 |   "trailingComma": "es5",
11 |   "semi": true,
12 |   "jsxSingleQuote": false,
13 |   "singleQuote": true,
14 |   "useTabs": false,
15 |   "tabWidth": 2
16 | };


--------------------------------------------------------------------------------
/.config/Dockerfile:
--------------------------------------------------------------------------------
 1 | ARG grafana_version=latest
 2 | ARG grafana_image=grafana-enterprise
 3 | 
 4 | FROM grafana/${grafana_image}:${grafana_version}
 5 | 
 6 | # Make it as simple as possible to access the grafana instance for development purposes
 7 | # Do NOT enable these settings in a public facing / production grafana instance
 8 | ENV GF_AUTH_ANONYMOUS_ORG_ROLE "Admin"
 9 | ENV GF_AUTH_ANONYMOUS_ENABLED "true"
10 | ENV GF_AUTH_BASIC_ENABLED "false"
11 | # Set development mode so plugins can be loaded without the need to sign
12 | ENV GF_DEFAULT_APP_MODE "development"
13 | 
14 | # Inject livereload script into grafana index.html
15 | USER root
16 | RUN sed -i 's/<\/body><\/html>/<script src=\"http:\/\/localhost:35729\/livereload.js\"><\/script><\/body><\/html>/g' /usr/share/grafana/public/views/index.html


--------------------------------------------------------------------------------
/.config/README.md:
--------------------------------------------------------------------------------
  1 | # Default build configuration by Grafana
  2 | 
  3 | **This is an auto-generated directory and is not intended to be changed! ⚠️**
  4 | 
  5 | The `.config/` directory holds basic configuration for the different tools
  6 | that are used to develop, test and build the project. In order to make it updates easier we ask you to
  7 | not edit files in this folder to extend configuration.
  8 | 
  9 | ## How to extend the basic configs?
 10 | 
 11 | Bear in mind that you are doing it at your own risk, and that extending any of the basic configuration can lead
 12 | to issues around working with the project.
 13 | 
 14 | ### Extending the ESLint config
 15 | 
 16 | Edit the `.eslintrc` file in the project root in order to extend the ESLint configuration.
 17 | 
 18 | **Example:**
 19 | 
 20 | ```json
 21 | {
 22 |   "extends": "./.config/.eslintrc",
 23 |   "rules": {
 24 |     "react/prop-types": "off"
 25 |   }
 26 | }
 27 | ```
 28 | 
 29 | ---
 30 | 
 31 | ### Extending the Prettier config
 32 | 
 33 | Edit the `.prettierrc.js` file in the project root in order to extend the Prettier configuration.
 34 | 
 35 | **Example:**
 36 | 
 37 | ```javascript
 38 | module.exports = {
 39 |   // Prettier configuration provided by Grafana scaffolding
 40 |   ...require('./.config/.prettierrc.js'),
 41 | 
 42 |   semi: false,
 43 | };
 44 | ```
 45 | 
 46 | ---
 47 | 
 48 | ### Extending the Jest config
 49 | 
 50 | There are two configuration in the project root that belong to Jest: `jest-setup.js` and `jest.config.js`.
 51 | 
 52 | **`jest-setup.js`:** A file that is run before each test file in the suite is executed. We are using it to
 53 | set up the Jest DOM for the testing library and to apply some polyfills. ([link to Jest docs](https://jestjs.io/docs/configuration#setupfilesafterenv-array))
 54 | 
 55 | **`jest.config.js`:** The main Jest configuration file that extends the Grafana recommended setup. ([link to Jest docs](https://jestjs.io/docs/configuration))
 56 | 
 57 | #### ESM errors with Jest
 58 | 
 59 | A common issue found with the current jest config involves importing an npm package which only offers an ESM build. These packages cause jest to error with `SyntaxError: Cannot use import statement outside a module`. To work around this we provide a list of known packages to pass to the `[transformIgnorePatterns](https://jestjs.io/docs/configuration#transformignorepatterns-arraystring)` jest configuration property. If need be this can be extended in the following way:
 60 | 
 61 | ```javascript
 62 | process.env.TZ = 'UTC';
 63 | const { grafanaESModules, nodeModulesToTransform } = require('./config/jest/utils');
 64 | 
 65 | module.exports = {
 66 |   // Jest configuration provided by Grafana
 67 |   ...require('./.config/jest.config'),
 68 |   // Inform jest to only transform specific node_module packages.
 69 |   transformIgnorePatterns: [nodeModulesToTransform([...grafanaESModules, 'packageName'])],
 70 | };
 71 | ```
 72 | 
 73 | ---
 74 | 
 75 | ### Extending the TypeScript config
 76 | 
 77 | Edit the `tsconfig.json` file in the project root in order to extend the TypeScript configuration.
 78 | 
 79 | **Example:**
 80 | 
 81 | ```json
 82 | {
 83 |   "extends": "./.config/tsconfig.json",
 84 |   "compilerOptions": {
 85 |     "preserveConstEnums": true
 86 |   }
 87 | }
 88 | ```
 89 | 
 90 | ---
 91 | 
 92 | ### Extending the Webpack config
 93 | 
 94 | Follow these steps to extend the basic Webpack configuration that lives under `.config/`:
 95 | 
 96 | #### 1. Create a new Webpack configuration file
 97 | 
 98 | Create a new config file that is going to extend the basic one provided by Grafana.
 99 | It can live in the project root, e.g. `webpack.config.ts`.
100 | 
101 | #### 2. Merge the basic config provided by Grafana and your custom setup
102 | 
103 | We are going to use [`webpack-merge`](https://github.com/survivejs/webpack-merge) for this.
104 | 
105 | ```typescript
106 | // webpack.config.ts
107 | import type { Configuration } from 'webpack';
108 | import { merge } from 'webpack-merge';
109 | import grafanaConfig from './.config/webpack/webpack.config';
110 | 
111 | const config = async (env): Promise<Configuration> => {
112 |   const baseConfig = await grafanaConfig(env);
113 | 
114 |   return merge(baseConfig, {
115 |     // Add custom config here...
116 |     output: {
117 |       asyncChunks: true,
118 |     },
119 |   });
120 | };
121 | 
122 | export default config;
123 | ```
124 | 
125 | #### 3. Update the `package.json` to use the new Webpack config
126 | 
127 | We need to update the `scripts` in the `package.json` to use the extended Webpack configuration.
128 | 
129 | **Update for `build`:**
130 | 
131 | ```diff
132 | -"build": "webpack -c ./.config/webpack/webpack.config.ts --env production",
133 | +"build": "webpack -c ./webpack.config.ts --env production",
134 | ```
135 | 
136 | **Update for `dev`:**
137 | 
138 | ```diff
139 | -"dev": "webpack -w -c ./.config/webpack/webpack.config.ts --env development",
140 | +"dev": "webpack -w -c ./webpack.config.ts --env development",
141 | ```
142 | 
143 | ### Configure grafana image to use when running docker
144 | 
145 | By default `grafana-enterprise` will be used as the docker image for all docker related commands. If you want to override this behaviour simply alter the `docker-compose.yaml` by adding the following build arg `grafana_image`. 
146 | 
147 | **Example:**
148 | 
149 | ```yaml
150 | version: '3.7'
151 | 
152 | services:
153 |   grafana:
154 |     container_name: 'myorg-basic-app'
155 |     build:
156 |       context: ./.config
157 |       args:
158 |         grafana_version: ${GRAFANA_VERSION:-9.1.2}
159 |         grafana_image: ${GRAFANA_IMAGE:-grafana}
160 | ```
161 | 
162 | In this example we are assigning the environment variable `GRAFANA_IMAGE` to the build arg `grafana_image` with a default value of `grafana`. This will give you the possibility to set the value while running the docker-compose commands which might be convinent in some scenarios.
163 | 
164 | ---
165 | 


--------------------------------------------------------------------------------
/.config/jest-setup.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in
 5 |  * https://grafana.github.io/plugin-tools/docs/advanced-configuration#extending-the-jest-config
 6 |  */
 7 | 
 8 | import '@testing-library/jest-dom';
 9 | 
10 | // https://jestjs.io/docs/manual-mocks#mocking-methods-which-are-not-implemented-in-jsdom
11 | Object.defineProperty(global, 'matchMedia', {
12 |   writable: true,
13 |   value: jest.fn().mockImplementation((query) => ({
14 |     matches: false,
15 |     media: query,
16 |     onchange: null,
17 |     addListener: jest.fn(), // deprecated
18 |     removeListener: jest.fn(), // deprecated
19 |     addEventListener: jest.fn(),
20 |     removeEventListener: jest.fn(),
21 |     dispatchEvent: jest.fn(),
22 |   })),
23 | });
24 | 
25 | HTMLCanvasElement.prototype.getContext = () => {};
26 | 


--------------------------------------------------------------------------------
/.config/jest.config.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in
 5 |  * https://grafana.github.io/plugin-tools/docs/advanced-configuration#extending-the-jest-config
 6 |  */
 7 | 
 8 | const path = require('path');
 9 | const { grafanaESModules, nodeModulesToTransform } = require('./jest/utils');
10 | 
11 | module.exports = {
12 |   moduleNameMapper: {
13 |     '\\.(css|scss|sass)$': 'identity-obj-proxy',
14 |     'react-inlinesvg': path.resolve(__dirname, 'jest', 'mocks', 'react-inlinesvg.tsx'),
15 |   },
16 |   modulePaths: ['<rootDir>/src'],
17 |   setupFilesAfterEnv: ['<rootDir>/jest-setup.js'],
18 |   testEnvironment: 'jest-environment-jsdom',
19 |   testMatch: [
20 |     '<rootDir>/src/**/__tests__/**/*.{js,jsx,ts,tsx}',
21 |     '<rootDir>/src/**/*.{spec,test,jest}.{js,jsx,ts,tsx}',
22 |     '<rootDir>/src/**/*.{spec,test,jest}.{js,jsx,ts,tsx}',
23 |   ],
24 |   transform: {
25 |     '^.+\\.(t|j)sx?$': [
26 |       '@swc/jest',
27 |       {
28 |         sourceMaps: 'inline',
29 |         jsc: {
30 |           parser: {
31 |             syntax: 'typescript',
32 |             tsx: true,
33 |             decorators: false,
34 |             dynamicImport: true,
35 |           },
36 |         },
37 |       },
38 |     ],
39 |   },
40 |   // Jest will throw `Cannot use import statement outside module` if it tries to load an
41 |   // ES module without it being transformed first. ./config/README.md#esm-errors-with-jest
42 |   transformIgnorePatterns: [nodeModulesToTransform(grafanaESModules)],
43 | };
44 | 


--------------------------------------------------------------------------------
/.config/jest/mocks/react-inlinesvg.tsx:
--------------------------------------------------------------------------------
 1 | // Due to the grafana/ui Icon component making fetch requests to
 2 | // `/public/img/icon/<icon_name>.svg` we need to mock react-inlinesvg to prevent
 3 | // the failed fetch requests from displaying errors in console.
 4 | 
 5 | import React from 'react';
 6 | 
 7 | type Callback = (...args: any[]) => void;
 8 | 
 9 | export interface StorageItem {
10 |   content: string;
11 |   queue: Callback[];
12 |   status: string;
13 | }
14 | 
15 | export const cacheStore: { [key: string]: StorageItem } = Object.create(null);
16 | 
17 | const SVG_FILE_NAME_REGEX = /(.+)\/(.+)\.svg$/;
18 | 
19 | const InlineSVG = ({ src }: { src: string }) => {
20 |   // testId will be the file name without extension (e.g. `public/img/icons/angle-double-down.svg` -> `angle-double-down`)
21 |   const testId = src.replace(SVG_FILE_NAME_REGEX, '$2');
22 |   return <svg xmlns="http://www.w3.org/2000/svg" data-testid={testId} viewBox="0 0 24 24" />;
23 | };
24 | 
25 | export default InlineSVG;
26 | 


--------------------------------------------------------------------------------
/.config/jest/utils.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in .config/README.md
 5 |  */
 6 | 
 7 | /*
 8 |  * This utility function is useful in combination with jest `transformIgnorePatterns` config
 9 |  * to transform specific packages (e.g.ES modules) in a projects node_modules folder.
10 |  */
11 | const nodeModulesToTransform = (moduleNames) => `node_modules\/(?!(${moduleNames.join('|')})\/)`;
12 | 
13 | // Array of known nested grafana package dependencies that only bundle an ESM version
14 | const grafanaESModules = [
15 |   '.pnpm', // Support using pnpm symlinked packages
16 |   '@grafana/schema',
17 |   'd3',
18 |   'd3-color',
19 |   'd3-force',
20 |   'd3-interpolate',
21 |   'd3-scale-chromatic',
22 |   'ol',
23 |   'react-colorful',
24 |   'rxjs',
25 |   'uuid',
26 | ];
27 | 
28 | module.exports = {
29 |   nodeModulesToTransform,
30 |   grafanaESModules,
31 | };
32 | 


--------------------------------------------------------------------------------
/.config/tsconfig.json:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
 3 |  *
 4 |  * In order to extend the configuration follow the steps in
 5 |  * https://grafana.github.io/plugin-tools/docs/advanced-configuration#extending-the-typescript-config
 6 |  */
 7 |  {
 8 |   "compilerOptions": {
 9 |     "alwaysStrict": true,
10 |     "declaration": false,
11 |     "rootDir": "../src",
12 |     "baseUrl": "../src",
13 |     "typeRoots": ["../node_modules/@types"],
14 |     "resolveJsonModule": true
15 |   },
16 |   "ts-node": {
17 |     "compilerOptions": {
18 |       "module": "commonjs",
19 |       "target": "es5",
20 |       "esModuleInterop": true
21 |     },
22 |     "transpileOnly": true
23 |   },
24 |   "include": ["../src", "./types"],
25 |   "extends": "@grafana/tsconfig"
26 | }
27 | 


--------------------------------------------------------------------------------
/.config/types/custom.d.ts:
--------------------------------------------------------------------------------
 1 | // Image declarations
 2 | declare module '*.gif' {
 3 |   const src: string;
 4 |   export default src;
 5 | }
 6 | 
 7 | declare module '*.jpg' {
 8 |   const src: string;
 9 |   export default src;
10 | }
11 | 
12 | declare module '*.jpeg' {
13 |   const src: string;
14 |   export default src;
15 | }
16 | 
17 | declare module '*.png' {
18 |   const src: string;
19 |   export default src;
20 | }
21 | 
22 | declare module '*.webp' {
23 |   const src: string;
24 |   export default src;
25 | }
26 | 
27 | declare module '*.svg' {
28 |   const content: string;
29 |   export default content;
30 | }
31 | 
32 | // Font declarations
33 | declare module '*.woff';
34 | declare module '*.woff2';
35 | declare module '*.eot';
36 | declare module '*.ttf';
37 | declare module '*.otf';
38 | 


--------------------------------------------------------------------------------
/.config/webpack/constants.ts:
--------------------------------------------------------------------------------
1 | export const SOURCE_DIR = 'src';
2 | export const DIST_DIR = 'dist';
3 | 


--------------------------------------------------------------------------------
/.config/webpack/utils.ts:
--------------------------------------------------------------------------------
 1 | import fs from 'fs';
 2 | import path from 'path';
 3 | import util from 'util';
 4 | import { glob } from 'glob';
 5 | import { SOURCE_DIR } from './constants';
 6 | 
 7 | export function getPackageJson() {
 8 |   return require(path.resolve(process.cwd(), 'package.json'));
 9 | }
10 | 
11 | export function getPluginJson() {
12 |   return require(path.resolve(process.cwd(), `${SOURCE_DIR}/plugin.json`));
13 | }
14 | 
15 | export function hasReadme() {
16 |   return fs.existsSync(path.resolve(process.cwd(), SOURCE_DIR, 'README.md'));
17 | }
18 | 
19 | // Support bundling nested plugins by finding all plugin.json files in src directory
20 | // then checking for a sibling module.[jt]sx? file.
21 | export async function getEntries(): Promise<Record<string, string>> {
22 |   const pluginsJson = await glob('**/src/**/plugin.json', { absolute: true });
23 | 
24 |   const plugins = await Promise.all(pluginsJson.map((pluginJson) => {
25 |       const folder = path.dirname(pluginJson);
26 |       return glob(`${folder}/module.{ts,tsx,js,jsx}`, { absolute: true });
27 |     })
28 |   );
29 | 
30 |   return plugins.reduce((result, modules) => {
31 |     return modules.reduce((result, module) => {
32 |       const pluginPath = path.dirname(module);
33 |       const pluginName = path.relative(process.cwd(), pluginPath).replace(/src\/?/i, '');
34 |       const entryName = pluginName === '' ? 'module' : `${pluginName}/module`;
35 | 
36 |       result[entryName] = module;
37 |       return result;
38 |     }, result);
39 |   }, {});
40 | }
41 | 


--------------------------------------------------------------------------------
/.config/webpack/webpack.config.ts:
--------------------------------------------------------------------------------
  1 | /*
  2 |  * ⚠️⚠️⚠️ THIS FILE WAS SCAFFOLDED BY `@grafana/create-plugin`. DO NOT EDIT THIS FILE DIRECTLY. ⚠️⚠️⚠️
  3 |  *
  4 |  * In order to extend the configuration follow the steps in
  5 |  * https://grafana.github.io/plugin-tools/docs/advanced-configuration#extending-the-webpack-config
  6 |  */
  7 | 
  8 | import CopyWebpackPlugin from 'copy-webpack-plugin';
  9 | import ESLintPlugin from 'eslint-webpack-plugin';
 10 | import ForkTsCheckerWebpackPlugin from 'fork-ts-checker-webpack-plugin';
 11 | import LiveReloadPlugin from 'webpack-livereload-plugin';
 12 | import path from 'path';
 13 | import ReplaceInFileWebpackPlugin from 'replace-in-file-webpack-plugin';
 14 | import { Configuration } from 'webpack';
 15 | 
 16 | import { getPackageJson, getPluginJson, hasReadme, getEntries } from './utils';
 17 | import { SOURCE_DIR, DIST_DIR } from './constants';
 18 | 
 19 | const pluginJson = getPluginJson();
 20 | 
 21 | const config = async (env): Promise<Configuration> => ({
 22 |   cache: {
 23 |     type: 'filesystem',
 24 |     buildDependencies: {
 25 |       config: [__filename],
 26 |     },
 27 |   },
 28 | 
 29 |   context: path.join(process.cwd(), SOURCE_DIR),
 30 | 
 31 |   devtool: env.production ? 'source-map' : 'eval-source-map',
 32 | 
 33 |   entry: await getEntries(),
 34 | 
 35 |   externals: [
 36 |     'lodash',
 37 |     'jquery',
 38 |     'moment',
 39 |     'slate',
 40 |     'emotion',
 41 |     '@emotion/react',
 42 |     '@emotion/css',
 43 |     'prismjs',
 44 |     'slate-plain-serializer',
 45 |     '@grafana/slate-react',
 46 |     'react',
 47 |     'react-dom',
 48 |     'react-redux',
 49 |     'redux',
 50 |     'rxjs',
 51 |     'react-router',
 52 |     'react-router-dom',
 53 |     'd3',
 54 |     'angular',
 55 |     '@grafana/ui',
 56 |     '@grafana/runtime',
 57 |     '@grafana/data',
 58 | 
 59 |     // Mark legacy SDK imports as external if their name starts with the "grafana/" prefix
 60 |     ({ request }, callback) => {
 61 |       const prefix = 'grafana/';
 62 |       const hasPrefix = (request) => request.indexOf(prefix) === 0;
 63 |       const stripPrefix = (request) => request.substr(prefix.length);
 64 | 
 65 |       if (hasPrefix(request)) {
 66 |         return callback(undefined, stripPrefix(request));
 67 |       }
 68 | 
 69 |       callback();
 70 |     },
 71 |   ],
 72 | 
 73 |   mode: env.production ? 'production' : 'development',
 74 | 
 75 |   module: {
 76 |     rules: [
 77 |       {
 78 |         exclude: /(node_modules)/,
 79 |         test: /\.[tj]sx?$/,
 80 |         use: {
 81 |           loader: 'swc-loader',
 82 |           options: {
 83 |             jsc: {
 84 |               baseUrl: path.resolve(process.cwd(), SOURCE_DIR),
 85 |               target: 'es2015',
 86 |               loose: false,
 87 |               parser: {
 88 |                 syntax: 'typescript',
 89 |                 tsx: true,
 90 |                 decorators: false,
 91 |                 dynamicImport: true,
 92 |               },
 93 |             },
 94 |           },
 95 |         },
 96 |       },
 97 |       {
 98 |         test: /\.css$/,
 99 |         use: ["style-loader", "css-loader"]
100 |       },
101 |       {
102 |         test: /\.s[ac]ss$/,
103 |         use: ['style-loader', 'css-loader', 'sass-loader'],
104 |       },
105 |       {
106 |         test: /\.(png|jpe?g|gif|svg)$/,
107 |         type: 'asset/resource',
108 |         generator: {
109 |           // Keep publicPath relative for host.com/grafana/ deployments
110 |           publicPath: `public/plugins/${pluginJson.id}/img/`,
111 |           outputPath: 'img/',
112 |           filename: Boolean(env.production) ? '[hash][ext]' : '[name][ext]',
113 |         },
114 |       },
115 |       {
116 |         test: /\.(woff|woff2|eot|ttf|otf)(\?v=\d+\.\d+\.\d+)?$/,
117 |         type: 'asset/resource',
118 |         generator: {
119 |           // Keep publicPath relative for host.com/grafana/ deployments
120 |           publicPath: `public/plugins/${pluginJson.id}/fonts/`,
121 |           outputPath: 'fonts/',
122 |           filename: Boolean(env.production) ? '[hash][ext]' : '[name][ext]',
123 |         },
124 |       },
125 |     ],
126 |   },
127 | 
128 |   output: {
129 |     clean: {
130 |       keep: new RegExp(`(.*?_(amd64|arm(64)?)(.exe)?|go_plugin_build_manifest)`),
131 |     },
132 |     filename: '[name].js',
133 |     library: {
134 |       type: 'amd',
135 |     },
136 |     path: path.resolve(process.cwd(), DIST_DIR),
137 |     publicPath: '/',
138 |   },
139 | 
140 |   plugins: [
141 |     new CopyWebpackPlugin({
142 |       patterns: [
143 |         // If src/README.md exists use it; otherwise the root README
144 |         // To `compiler.options.output`
145 |         { from: hasReadme() ? 'README.md' : '../README.md', to: '.', force: true },
146 |         { from: 'plugin.json', to: '.' },
147 |         { from: '../LICENSE', to: '.' },
148 |         { from: '../CHANGELOG.md', to: '.', force: true },
149 |         { from: '**/*.json', to: '.' }, // TODO<Add an error for checking the basic structure of the repo>
150 |         { from: '**/*.svg', to: '.', noErrorOnMissing: true }, // Optional
151 |         { from: '**/*.png', to: '.', noErrorOnMissing: true }, // Optional
152 |         { from: '**/*.html', to: '.', noErrorOnMissing: true }, // Optional
153 |         { from: 'img/**/*', to: '.', noErrorOnMissing: true }, // Optional
154 |         { from: 'libs/**/*', to: '.', noErrorOnMissing: true }, // Optional
155 |         { from: 'static/**/*', to: '.', noErrorOnMissing: true }, // Optional
156 |       ],
157 |     }),
158 |     // Replace certain template-variables in the README and plugin.json
159 |     new ReplaceInFileWebpackPlugin([
160 |       {
161 |         dir: DIST_DIR,
162 |         files: ['plugin.json', 'README.md'],
163 |         rules: [
164 |           {
165 |             search: /\%VERSION\%/g,
166 |             replace: getPackageJson().version,
167 |           },
168 |           {
169 |             search: /\%TODAY\%/g,
170 |             replace: new Date().toISOString().substring(0, 10),
171 |           },
172 |           {
173 |             search: /\%PLUGIN_ID\%/g,
174 |             replace: pluginJson.id,
175 |           },
176 |         ],
177 |       },
178 |     ]),
179 |     new ForkTsCheckerWebpackPlugin({
180 |       async: Boolean(env.development),
181 |       issue: {
182 |         include: [{ file: '**/*.{ts,tsx}' }],
183 |       },
184 |       typescript: { configFile: path.join(process.cwd(), 'tsconfig.json') },
185 |     }),
186 |     new ESLintPlugin({
187 |       extensions: ['.ts', '.tsx'],
188 |       lintDirtyModulesOnly: Boolean(env.development), // don't lint on start, only lint changed files
189 |     }),
190 |     ...(env.development ? [new LiveReloadPlugin()] : []),
191 |   ],
192 | 
193 |   resolve: {
194 |     extensions: ['.js', '.jsx', '.ts', '.tsx'],
195 |     // handle resolving "rootDir" paths
196 |     modules: [path.resolve(process.cwd(), 'src'), 'node_modules'],
197 |     unsafeCache: true,
198 |   },
199 | });
200 | 
201 | export default config;
202 | 


--------------------------------------------------------------------------------
/.eslintrc:
--------------------------------------------------------------------------------
1 | {
2 |   "extends": "./.config/.eslintrc"
3 | }


--------------------------------------------------------------------------------
/.github/workflows/codeql-analysis.yml:
--------------------------------------------------------------------------------
 1 | name: "CodeQL"
 2 | 
 3 | on:
 4 |   push:
 5 |     branches: [ main ]
 6 |   pull_request:
 7 |     branches: [ main ]
 8 |   schedule:
 9 |     - cron: '15 21 * * 5'
10 | 
11 | jobs:
12 |   analyze:
13 |     name: Analyze
14 |     runs-on: ubuntu-latest
15 | 
16 |     strategy:
17 |       fail-fast: false
18 |       matrix:
19 |         language: [ 'go', 'typescript' ]
20 | 
21 |     steps:
22 |     - name: Checkout repository
23 |       uses: actions/checkout@v2
24 | 
25 |     - name: Initialize CodeQL
26 |       uses: github/codeql-action/init@v1
27 |       with:
28 |         languages: ${{ matrix.language }}
29 | 
30 |     - name: Autobuild
31 |       uses: github/codeql-action/autobuild@v1
32 | 
33 |     - name: Perform CodeQL Analysis
34 |       uses: github/codeql-action/analyze@v1
35 | 


--------------------------------------------------------------------------------
/.github/workflows/pr-tests.yml:
--------------------------------------------------------------------------------
 1 | name: Run tests
 2 | on:
 3 |   pull_request:
 4 |     branches: [ main ]
 5 |   workflow_dispatch: ~
 6 | jobs:
 7 |   build:
 8 |     runs-on: ubuntu-latest
 9 |     steps:
10 |       - name: Checkout the repository
11 |         uses: actions/checkout@master
12 |       - name: yarn install
13 |         run: make fe-deps
14 |       - name: yarn build
15 |         run: make fe-build
16 |       - name: go mod vendor
17 |         run: make be-deps
18 |       - name: go build linux
19 |         run: make be-build
20 |       - name: backend tests
21 |         run: make be-test
22 | 


--------------------------------------------------------------------------------
/.github/workflows/release.yml:
--------------------------------------------------------------------------------
 1 | on:
 2 |   release:
 3 |     types: [created]
 4 | name: Handle Release
 5 | jobs:
 6 |   generate:
 7 |     name: Create release artifacts
 8 |     runs-on: ubuntu-latest
 9 |     steps:
10 |       - name: Checkout the repository
11 |         uses: actions/checkout@master      
12 |       - name: yarn install
13 |         run: make fe-deps
14 |       - name: yarn build
15 |         run: make fe-build
16 |       - name: go mod vendor
17 |         run: make be-deps
18 |       - name: go build linux
19 |         run: make be-build
20 |       - name: backend tests 
21 |         run: make be-test 
22 |       - name: go build windows
23 |         run: make OS=windows ARCH=amd64 be-build
24 |       - name: go build darwin
25 |         run: make OS=darwin ARCH=amd64 be-build
26 |       - name: go build arm64 (m1)
27 |         run: make OS=darwin ARCH=arm64 be-build
28 |       - name: sign the build
29 |         run: docker run --rm -v ${PWD}:/opt/gcds -w /opt/gcds -e GRAFANA_ACCESS_POLICY_TOKEN=${{ secrets.GRAFANA_ACCESS_POLICY_TOKEN }} node:20-alpine yarn sign
30 |       - name: Package plugin
31 |         id: package-plugin
32 |         run: |
33 |           mv dist/ hadesarchitect-cassandra-datasource
34 |           zip -r cassandra-datasource-${{ github.event.release.tag_name }}.zip ./hadesarchitect-cassandra-datasource
35 |           md5sum cassandra-datasource-${{ github.event.release.tag_name }}.zip > cassandra-datasource-${{ github.event.release.tag_name }}.zip.md5
36 |       - name: Upload the artifacts
37 |         uses: skx/github-action-publish-binaries@master
38 |         env:
39 |           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
40 |         with:
41 |           args: './cassandra-datasource-${{ github.event.release.tag_name }}.*'
42 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | yarn-debug.log*
 3 | yarn-error.log*
 4 | 
 5 | node_modules
 6 | dist
 7 | vendor
 8 | .tscache
 9 | coverage
10 | .idea
11 | .vscode
12 | 
13 | # OS generated files
14 | .DS_Store
15 | 


--------------------------------------------------------------------------------
/.prettierrc.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |   // Prettier configuration provided by Grafana scaffolding
3 |   ...require("./.config/.prettierrc.js")
4 | };


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # v3.1.1
 2 | 
 3 | * Updated frontend dependencies to latest compatible versions:
 4 |   - @grafana/data, @grafana/runtime, @grafana/ui remain at 10.4.19 (latest 10.x)
 5 |   - @grafana/e2e remains at 10.4.12 (latest available for 10.x)
 6 |   - @grafana/e2e-selectors remains at 10.4.19
 7 |   - @grafana/eslint-config remains at 6.0.1
 8 |   - @grafana/tsconfig remains at 2.0.0
 9 |   - TypeScript updated to 5.8.3
10 |   - Webpack updated to 5.99.9
11 |   - webpack-cli updated to 6.0.1
12 |   - @swc/helpers updated to 0.5.13
13 |   - @testing-library/jest-dom updated to 6.6.3
14 |   - @types/jest updated to 29.5.14
15 |   - @types/lodash updated to 4.17.13
16 |   - @types/node updated to 22.10.6
17 |   - css-loader updated to 7.1.2
18 |   - sass-loader updated to 16.0.4
19 |   - style-loader updated to 4.0.0
20 |   - glob updated to 11.0.0
21 |   - prettier updated to 3.4.2
22 |   - Other dependencies remain at current stable versions
23 | * Updated backend dependencies to latest compatible versions:
24 |   - Updated Go version from 1.21 to 1.24.1
25 |   - Updated core dependencies:
26 |     - github.com/gocql/gocql: v1.5.2 → v1.7.0
27 |     - github.com/grafana/grafana-plugin-sdk-go: v0.172.0 → v0.277.1
28 |     - github.com/stretchr/testify: v1.8.4 → v1.10.0
29 |   - Notable indirect dependency updates:
30 |     - OpenTelemetry packages updated to v1.36.0
31 |     - gRPC updated to v1.72.1
32 |     - Protocol Buffers updated to v1.36.6
33 |   - Compatibility fixes:
34 |     - Downgraded tablewriter from v1.0.6 to v0.0.5 for SDK compatibility
35 |     - Updated datasource factory function to include context parameter
36 | * Updated vendor directory to sync with go.mod
37 | * Updated Docker Compose Grafana image from 10.1.2 to 10.4.19 (latest 10.x)
38 | * Fixed compatibility issues with missing @grafana/e2e version
39 | * Note: @grafana/e2e is deprecated in favor of @grafana/plugin-e2e for newer Grafana versions
40 | 
41 | # v3.1.0
42 | 
43 | * Updated frontend dependencies to latest compatible versions
44 | * Updated @grafana packages to 10.4.18
45 | * Updated testing and build dependencies
46 | * Increased minimum Node.js version to 18
47 | 
48 | # v3.0.0
49 | 
50 | **IMPORTANT** v3 supports Grafana versions 7.4+ through 10.x
51 | 
52 | * Added support for Grafana 10.x
53 | * Enhanced security features including TLS support
54 | * Support for various Cassandra implementations (Apache Cassandra, DataStax Enterprise, DataStax Astra, AWS Keyspaces)
55 | * Modernized plugin architecture with backend and frontend components
56 | 
57 | # v2.0.0
58 | 
59 | **IMPORTANT** v2 does NOT support older grafana versions (any version older than 7.0)
60 | 
61 | * Added support for Grafana 8.x (#89)
62 | * Added Alerting (#91)
63 | * Added table format support (#66)
64 | * Added aliases (#92)
65 | * UX Query Editor Improvements (#93)
66 | 
67 | All credits to [@futuarmo](https://www.linkedin.com/in/armen-khachkinaev)
68 | 
69 | # v1.1.4
70 | 
71 | * Configurable connection timeout
72 | * Configurable TLS setting (allow/disallow self-signed certs)
73 | * UI configuration improvements
74 | * Fronted dependencies update
75 | 
76 | # v1.0.1
77 | 
78 | * Supports linux ARM64 platform
79 | * Updated dependencies
80 | 
81 | # v1.0.0 Initial
82 | 
83 | * First implementation


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2020 Aleksandr Volochnev, Aleksei Slavianskii
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 6 | 
 7 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 8 | 
 9 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
10 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
 1 | .PHONY: help
 2 | help: ## This help
 3 | 	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
 4 | .DEFAULT_GOAL := help
 5 | 
 6 | OS=linux
 7 | ARCH=amd64
 8 | GOLANG=1.24.3
 9 | NODE=20
10 | 
11 | install: fe-deps be-deps ## install datasource dependencies (front and back)
12 | 
13 | build: clean fe-build be-build ## Build the whole datasource
14 | 
15 | frontend: fe-deps fe-build ## Install frontend dependencies and build frontend
16 | 
17 | backend: be-deps be-build ## Install backend dependencies and build backend
18 | 
19 | test: be-test ## Run unit tests
20 | 
21 | clean: ## Cleans destination folder
22 | 	rm -rf ./dist/*
23 | 
24 | start: ## Launches dev environment
25 | 	docker-compose up -d
26 | 
27 | stop: ## Stops dev environment
28 | 	docker-compose stop
29 | 
30 | fe-deps: ## Install frontend dependencies
31 | 	docker run --rm -v ${PWD}:/opt/gcds -w /opt/gcds node:${NODE}-alpine yarn install
32 | 
33 | fe-build: ## Build frontend
34 | 	docker run --rm -v ${PWD}:/opt/gcds -w /opt/gcds node:${NODE}-alpine yarn build
35 | 
36 | fe-watch: ## Watch frontend
37 | 	docker run --rm -v ${PWD}:/opt/gcds -w /opt/gcds node:${NODE}-alpine yarn watch
38 | 
39 | be-deps: ## Install backend dependencies
40 | 	docker run --rm -v ${PWD}:/go/src/github.com/ha/gcp -w /go/src/github.com/ha/gcp/backend golang:${GOLANG}-alpine go mod vendor
41 | 
42 | be-tidy: ## Go mod tidy
43 | 	docker run --rm -v ${PWD}:/go/src/github.com/ha/gcp -w /go/src/github.com/ha/gcp/backend golang:${GOLANG}-alpine go mod tidy
44 | 
45 | be-build: ## Build backend (Builds linux-amd64 version by deafult. Run with args to adjust target (make be-build OS=windows ARCH=arm64))
46 | 	docker run --rm -v ${PWD}:/go/src/github.com/ha/gcp -w /go/src/github.com/ha/gcp/backend -e CGO_ENABLED=0 -e GOOS=$(OS) -e GOARCH=$(ARCH) golang:${GOLANG}-alpine go build -buildvcs=false -o ../dist/cassandra-plugin_$(OS)_$(ARCH) .
47 | 
48 | be-test: ## Run backend unit tests
49 | 	docker run --rm -v ${PWD}:/go/src/github.com/ha/gcp -w /go/src/github.com/ha/gcp/backend golang:${GOLANG}-alpine go test ./...
50 | # backend tests in CI required `-vet=off`
51 | # docker run --rm -v ${PWD}:/go/src/github.com/ha/gcp -w /go/src/github.com/ha/gcp/backend golang:1-alpine go test -buildvcs=false -v -vet=off ./...


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Apache Cassandra Datasource for Grafana
  2 | 
  3 | This datasource is to visualise **time-series data** stored in Cassandra/DSE, if you are looking for Cassandra **metrics**, you may need [datastax/metric-collector-for-apache-cassandra](https://github.com/datastax/metric-collector-for-apache-cassandra) instead.
  4 | 
  5 | To see the datasource in action, please follow the [Quick Demo](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/Quick-Demo) steps. Documentation is available [here](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki)
  6 | 
  7 | **Supports**:
  8 | 
  9 | * Grafana 
 10 |     * 7.4 - 12.x are fully supported (plugin version 3.x)
 11 |     * 5.x, 6.x, 7.0-7.3 are deprecated (works with plugin versions 1.x/2.x, but we recommend upgrading)
 12 | * Cassandra 3.x, 4.x, 5.x
 13 | * DataStax Enterprise 6.x
 14 | * DataStax Astra ([docs](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/DataStax-Astra))
 15 | * AWS Keyspaces (limited support) ([docs](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/AWS-Keyspaces))
 16 | * Linux, OSX (incl. M1), Windows
 17 | 
 18 | **Features**:
 19 | * Connect to Cassandra using auth credentials and TLS
 20 | * Query configurator
 21 | * Raw CQL query editor
 22 | * Table mode
 23 | * Variables
 24 | * Annotations
 25 | * Alerting
 26 | 
 27 | **Contacts**:
 28 | 
 29 | * [![Github discussions](https://img.shields.io/badge/github-discussions-green)](https://github.com/HadesArchitect/GrafanaCassandraDatasource/discussions)
 30 | 
 31 | **TOC**
 32 | - [About](#about)
 33 | - [Usage](#usage)
 34 | - [Installation](#installation)
 35 | - [Building query](#building-query)
 36 | - [Table Mode](#table-mode)
 37 | - [Alerting](#alerting)
 38 | - [Tips and tricks](#tips-and-tricks)
 39 | - [Development](#tips-and-tricks)
 40 | 
 41 | ## Usage
 42 | 
 43 | You can find more detailed instructions in [the datasource wiki](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki).
 44 | 
 45 | ### Installation
 46 | 
 47 | 1. Install the plugin using grafana console tool: `grafana-cli plugins install hadesarchitect-cassandra-datasource`. The plugin will be installed into your grafana plugins directory; the default is `/var/lib/grafana/plugins`. Alternatively, download the plugin using [latest release](https://github.com/HadesArchitect/GrafanaCassandraDatasource/releases/latest), please download `cassandra-datasource-VERSION.zip` and uncompress a file into the Grafana plugins directory (`grafana/plugins`).
 48 | 2. Add the Apache Cassandra Data Source as a data source at the datasource configuration page.
 49 | 3. Configure the datasource specifying contact point and port like "10.11.12.13:9042", username and password. It's strongly recommended to use a dedicated user with read-only permissions only to the table you have to access.
 50 | 4. Push the "Save and Test" button, if there is an error message, check the credentials and connection. 
 51 | 
 52 | ![Datasource Configuration](https://user-images.githubusercontent.com/1742301/148654400-3ac4a477-8ca3-4606-86e7-5d10cbdc4ea9.png)
 53 | 
 54 | ### Building query
 55 | 
 56 | There are **two ways** to query data from Cassandra/DSE, **Query Configurator** and **Query Editor**. Configurator is easier to use but has limited capabilities, Editor is more powerful but requires understanding of [CQL](https://cassandra.apache.org/doc/latest/cql/). 
 57 | 
 58 | #### Query Configurator
 59 | 
 60 | ![Query Configurator](https://user-images.githubusercontent.com/1742301/148654262-b9cb7253-4086-4367-8aae-35ea458fcbb6.png)
 61 | 
 62 | Query Configurator is the easiest way to query data. At first, enter the keyspace and table name, then pick proper columns. If keyspace and table names are given correctly, the datasource will suggest the column names automatically.
 63 | 
 64 | * **Time Column** - the column storing the timestamp value, it's used to answer "when" question. 
 65 | * **Value Column** - the column storing the value you'd like to show. It can be the `value`, `temperature` or whatever property you need.
 66 | * **ID Column** - the column to uniquely identify the source of the data, e.g. `sensor_id`, `shop_id` or whatever allows you to identify the origin of data.
 67 | 
 68 | After that, you have to specify the `ID Value`, the particular ID of the data origin you want to show. You may need to enable "ALLOW FILTERING" although we recommend to avoid it.
 69 | 
 70 | **Example** Imagine you want to visualise reports of a temperature sensor installed in your smart home. Given the sensor reports its ID, time, location and temperature every minute, we create a table to store the data and put some values there:
 71 | 
 72 | ```
 73 | CREATE TABLE IF NOT EXISTS temperature (
 74 |     sensor_id uuid,
 75 |     registered_at timestamp,
 76 |     temperature int,
 77 |     location text,
 78 |     PRIMARY KEY ((sensor_id), registered_at)
 79 | );
 80 | 
 81 | insert into temperature (sensor_id, registered_at, temperature, location) values (99051fe9-6a9c-46c2-b949-38ef78858dd0, 2020-04-01T11:21:59.001+0000, 18, "kitchen");
 82 | insert into temperature (sensor_id, registered_at, temperature, location) values (99051fe9-6a9c-46c2-b949-38ef78858dd0, 2020-04-01T11:22:59.001+0000, 19, "kitchen");
 83 | insert into temperature (sensor_id, registered_at, temperature, location) values (99051fe9-6a9c-46c2-b949-38ef78858dd0, 2020-04-01T11:23:59.001+0000, 20, "kitchen");
 84 | ```
 85 | 
 86 | In this case, we have to fill the configurator fields the following way to get the results:
 87 | 
 88 | * **Keyspace** - smarthome *(keyspace name)*
 89 | * **Table** - temperature *(table name)*
 90 | * **Time Column** - registered_at *(occurence)*
 91 | * **Value Column** - temperature *(value to show)*
 92 | * **ID Column** - sensor_id *(ID of the data origin)*
 93 | * **ID Value** - 99051fe9-6a9c-46c2-b949-38ef78858dd0 *ID of the sensor*
 94 | * **ALLOW FILTERING** - FALSE *(not required, so we are happy to avoid)*
 95 | 
 96 | In case of a few origins (multiple sensors) you will need to add more rows. If your case is as simple as that, query configurator will be a good choice, otherwise  please proceed to the query editor.
 97 | 
 98 | #### Query Editor
 99 | 
100 | Query Editor is more powerful way to query data. To enable query editor, press "toggle text edit mode" button.
101 | 
102 | ![102781863-a8bd4b80-4398-11eb-8c28-4d06a1f29279](https://user-images.githubusercontent.com/1742301/148654475-6718f3ff-1290-4d7a-a40b-dc107c52ac15.png)
103 | 
104 | Query Editor unlocks all possibilities of CQL including Used-Defined Functions, aggregations etc. 
105 | 
106 | Example (using the sample table from the Query Configurator case):
107 | 
108 | ```
109 | SELECT sensor_id, temperature, registered_at, location FROM test.test WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd1, 99051fe9-6a9c-46c2-b949-38ef78858dd0) AND registered_at > $__timeFrom and registered_at < $__timeTo
110 | ```
111 | 
112 | 1. Order of fields in the SELECT expression doesn't matter except `ID` field. This field used to distinguish different time series, so it is important to keep it or any other column with low cardinality on the first position.
113 | * **Identifier** - the first property in the SELECT expression should be the ID, something that uniquely identifies the data (e.g. `sensor_id`)
114 | * **Value** - There should be at least one numeric value among returned fields, if query result will be used to draw graph.
115 | * **Timestamp** - There should be one timestamp value, if query result will be used to draw graph.
116 | * There could be any number of additional fields, however be cautious when using multiple numeric fields as they are interpreted as values by grafana and therefore are drawn on TimeSeries graph.
117 | * Any field returned by query is available to use in `Alias` template, e.g. `{{ location }}`. Datasource interpolates such strings and updates graph legend. 
118 | * Datasource will try to keep all the fields, however it is not always possible since cassandra and grafana use different sets of supported types. Unsupported fields will be removed from response.
119 | 
120 | 2. To filter data by time, use `$__timeFrom` and `$__timeTo` placeholders as in the example. The datasource will replace them with time values from the panel. **Notice** It's important to add the placeholders otherwise query will try to fetch data for the whole period of time. Don't try to specify the timeframe on your own, just put the placeholders. It's grafana's job to specify time limits.
121 | 
122 | ![103153625-1fd85280-4792-11eb-9c00-085297802117](https://user-images.githubusercontent.com/1742301/148654522-8e50617d-0ba9-4c5a-a3f0-7badec92e31f.png)
123 | 
124 | ### Table Mode
125 | In addition to TimeSeries mode datasource supports Table mode to draw tables using Cassandra query results. Use `Merge`, `Sort by`, `Organize fields` and other transformations to shape the table in any desirable way.
126 | There are two ways to plot not a whole timeseries but only last(most rescent) values.
127 | 1. Inefficient way
128 | 
129 | In case if table created with default ascending ordering the most recent value is always stored in the end of partition. To retrieve it `ORDER BY` and `LIMIT` clauses must be used in query:
130 | ```
131 | SELECT sensor_id, temperature, registered_at, location
132 | FROM test.test
133 | WHERE sensor_id = 99051fe9-6a9c-46c2-b949-38ef78858dd0
134 | AND registered_at > $__timeFrom and registered_at < $__timeTo
135 | ORDER BY registered_at
136 | LIMIT 1
137 | ```
138 | Note that `WHERE IN ()` clause could not be used with `ORDER BY`, so query must be duplicated for any additional `sensor_id`.
139 | 
140 | 2. Efficient way
141 | 
142 | To query the most recent values efficiently ordering must be specified during the table creation:
143 | ```
144 | CREATE TABLE IF NOT EXISTS temperature (
145 |     sensor_id uuid,
146 |     registered_at timestamp,
147 |     temperature int,
148 |     location text,
149 |     PRIMARY KEY ((sensor_id), registered_at)
150 | ) WITH CLUSTERING ORDER BY (registered_at DESC);
151 | ```
152 | After that the most recent value will always be stored in the beginning of partition and could be queried with just `LIMIT` clause:
153 | ```
154 | SELECT sensor_id, temperature, registered_at, room_name
155 | FROM test.test
156 | WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd0, 99051fe9-6a9c-46c2-b949-38ef78858dd0)
157 | AND registered_at > $__timeFrom AND registered_at < $__timeTo
158 | PER PARTITION LIMIT 1
159 | ```
160 | Note that `PER PARTITION LIMIT 1` used instead of `LIMIT 1` to query one row for each partition and not just one row total.
161 | 
162 | ### Variables
163 | - [Configuring variables in Cassandra Datasource](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/Variables)
164 | - [Grafana Variables documentation](https://grafana.com/docs/grafana/latest/dashboards/variables/)
165 | 
166 | ### Aliases
167 | Using aliases explained in [documentation](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/Aliases)
168 | 
169 | ### Annotations
170 | [Grafana Annotations documentation](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/annotate-visualizations/)
171 | 
172 | ### Alerting
173 | Alerting is supported, however it has some limitations. Grafana does not support long(narrow) series in alerting, 
174 | so query result must be converted to wide series before handing it over to grafana. Datasource performs it in pretty
175 | simple way - it creates labels using all the non-timeseries field and then removes that fields from response.
176 | Basically, this query(using example table)
177 | ```
178 | SELECT sensor_id, temperature, registered_at, location
179 | FROM test.test
180 | WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd0, 99051fe9-6a9c-46c2-b949-38ef78858dd0)
181 | AND registered_at > $__timeFrom AND registered_at < $__timeTo
182 | ```
183 | will produce two wide series for alerting
184 | ```
185 | 99051fe9-6a9c-46c2-b949-38ef78858dd0 {location="kitchen", sensor_id="99051fe9-6a9c-46c2-b949-38ef78858dd0"}
186 | 99051fe9-6a9c-46c2-b949-38ef78858dd1 {location="bedroom", sensor_id="99051fe9-6a9c-46c2-b949-38ef78858dd1"}
187 | 
188 | 
189 | ```
190 | More information on series types in [grafana developers documentation](https://grafana.com/developers/plugin-tools/introduction/data-frames#data-frames-as-time-series).
191 | 
192 | [Grafana Alerting documentation](https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-grafana-managed-rule/)
193 | 
194 | ### Tips and tricks
195 | 
196 | #### Unix epoch time format
197 | Usually there are no problems - Cassandra can store timestamps using different formats as shown in [documentation](https://cassandra.apache.org/doc/latest/cassandra/cql/types.html#timestamps).
198 | However, it is not always enough. One of possible cases could be unix time, which is just number of seconds or milliseconds and usually stored as integer type.
199 | 1. If time is stored as a number of milliseconds in a `bigint` column, then it should be converted into the `timestamp` type before return the data to grafana:
200 | ```
201 | SELECT sensor_id, temperature, dateOf(maxTimeuuid(registered_at)), location
202 | FROM test.test WHERE sensor_id = 99051fe9-6a9c-46c2-b949-38ef78858dd0
203 | AND registered_at > $__timeFrom AND registered_at < $__timeTo
204 | ```
205 | This query returns proper timestamp even if it stored as number of milliseconds.
206 | 
207 | 2. If time is stored as a number of seconds, then it is not possible to convert it into the timestamp natively, but there is a trick:
208 | ```
209 | SELECT sensor_id, temperature, dateOf(maxTimeuuid(registered_at*1000)), location
210 | FROM test.test WHERE sensor_id = 99051fe9-6a9c-46c2-b949-38ef78858dd0
211 | AND registered_at > $__unixEpochFrom AND registered_at < $__unixEpochTo
212 | ```
213 | * There are two important parts in this query:
214 |   * `dateOf(maxTimeuuid(registered_at*1000))` used to convert seconds to milliseconds(`registered_at*1000`) and then to convert milliseconds to `timestamp` type, which is handed over to grafana.
215 |   * `$__unixEpochFrom` and `$__unixEpochTo` are variables with unix time in the seconds format that are used to fill out conditions part of the query.
216 | 
217 | #### Cassandra fat partitions
218 | Cassandra stores data in `partitions` which are minimal storage units for the DB. It means that using the example table
219 | ```
220 | CREATE TABLE IF NOT EXISTS temperature (
221 |     sensor_id uuid,
222 |     registered_at timestamp,
223 |     temperature int,
224 |     PRIMARY KEY ((sensor_id), registered_at)
225 | );
226 | ```
227 | will lead to partitions bloating and performance degradation, because all the data for all time for specific `sensor_id` is stored in just one partition(first part of `PRIMARY KEY` is `PARTITION KEY`).
228 | To avoid that there is a technique called `bucketing`, which basically means that partitions are split up into smaller pieces.
229 | For instance, we can split that example table partitions by time: year, month, day, or even hour and less. What to choose depends on how
230 | much data stored in each partition. To achieve that the example table has to be modified like this:
231 | ```
232 | CREATE TABLE IF NOT EXISTS temperature (
233 |     sensor_id uuid,
234 |     date date,
235 |     registered_at timestamp,
236 |     temperature int,
237 |     PRIMARY KEY ((sensor_id, date), registered_at)
238 | );
239 | ```
240 | After that change the database schema became more effective because of bucketing by date, and queries will have a form of
241 | ```
242 | SELECT sensor_id, temperature, registered_at
243 | FROM temperature
244 | WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd1, 99051fe9-6a9c-46c2-b949-38ef78858dd0) 
245 | AND date = '${__from:date:YYYY-MM-DD}'
246 | AND registered_at > $__timeFrom 
247 | AND registered_at < $__timeTo
248 | ```
249 | Note that `$__from`/`$__to` variables are used. They are [grafana built-in variables](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/#__from-and-__to), and they have formatting capabilities which are perfect for our case.
250 | In case when time range includes more than one day, each day has to be added into `AND date IN (...)` predicate. Another way to make it more convenient is to consider using larger buckets, e.g. month instead of day-size.
251 | 
252 | ## Development
253 | 
254 | [Developer documentation](https://github.com/HadesArchitect/GrafanaCassandraDatasource/wiki/Developer-Guide)
255 | 


--------------------------------------------------------------------------------
/backend/cassandra/row.go:
--------------------------------------------------------------------------------
 1 | package cassandra
 2 | 
 3 | import (
 4 | 	"fmt"
 5 | 	"net"
 6 | 	"time"
 7 | 
 8 | 	"github.com/gocql/gocql"
 9 | )
10 | 
11 | type Row struct {
12 | 	Columns []string
13 | 	Fields  map[string]interface{}
14 | }
15 | 
16 | // normalize checks the type of returned field and in case if
17 | // it is not supported by grafana tries to convert it to a supported type.
18 | // If some field has type that cannot be converted then error is returned.
19 | // Type mappings are based on these:
20 | // Cassandra gocql types: https://github.com/gocql/gocql/blob/master/marshal.go#L164
21 | // Grafana field types: https://github.com/grafana/grafana-plugin-sdk-go/blob/main/data/field.go#L39
22 | func (r *Row) normalize() error {
23 | 	for _, colName := range r.Columns {
24 | 		switch v := r.Fields[colName].(type) {
25 | 		case int8, int16, int32, int64, float32, float64, string, bool, time.Time:
26 | 		// nulls are not supported yet, so just in case they will`
27 | 		// https://github.com/gocql/gocql/issues/1248
28 | 		case *int, *int8, *int16, *int32, *int64, *float32, *float64, *string, *bool:
29 | 		case int:
30 | 			r.Fields[colName] = int64(v)
31 | 		case []byte:
32 | 			r.Fields[colName] = string(v)
33 | 		case net.IP:
34 | 			r.Fields[colName] = v.String()
35 | 		case gocql.UUID:
36 | 			r.Fields[colName] = v.String()
37 | 		default:
38 | 			return fmt.Errorf("field %s has unsupported type %T", colName, v)
39 | 		}
40 | 	}
41 | 
42 | 	return nil
43 | }
44 | 


--------------------------------------------------------------------------------
/backend/cassandra/row_test.go:
--------------------------------------------------------------------------------
  1 | package cassandra
  2 | 
  3 | import (
  4 | 	"fmt"
  5 | 	"net"
  6 | 	"testing"
  7 | 	"time"
  8 | 
  9 | 	"github.com/gocql/gocql"
 10 | 	"github.com/stretchr/testify/assert"
 11 | )
 12 | 
 13 | func TestRow_normalize(t *testing.T) {
 14 | 	testCases := []struct {
 15 | 		name    string
 16 | 		input   *Row
 17 | 		want    *Row
 18 | 		wantErr error
 19 | 	}{
 20 | 		{
 21 | 			name:    "empty",
 22 | 			input:   &Row{},
 23 | 			want:    &Row{},
 24 | 			wantErr: nil,
 25 | 		},
 26 | 		{
 27 | 			name: "normal row",
 28 | 			input: &Row{
 29 | 				Columns: []string{"id", "time", "value"},
 30 | 				Fields:  map[string]interface{}{"id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 31 | 			},
 32 | 			want: &Row{
 33 | 				Columns: []string{"id", "time", "value"},
 34 | 				Fields:  map[string]interface{}{"id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 35 | 			},
 36 | 			wantErr: nil,
 37 | 		},
 38 | 		{
 39 | 			name: "normal row with nil in the beginning",
 40 | 			input: &Row{
 41 | 				Columns: []string{"field1", "id", "time", "value"},
 42 | 				Fields:  map[string]interface{}{"field1": nil, "id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 43 | 			},
 44 | 			want: &Row{
 45 | 				Columns: []string{"field1", "id", "time", "value"},
 46 | 				Fields:  map[string]interface{}{"field1": nil, "id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 47 | 			},
 48 | 			wantErr: fmt.Errorf("field %s has unsupported type %T", "field1", nil),
 49 | 		},
 50 | 		{
 51 | 			name: "normal row with nil in the end",
 52 | 			input: &Row{
 53 | 				Columns: []string{"id", "time", "value", "field1"},
 54 | 				Fields:  map[string]interface{}{"id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1, "field1": nil},
 55 | 			},
 56 | 			want: &Row{
 57 | 				Columns: []string{"id", "time", "value", "field1"},
 58 | 				Fields:  map[string]interface{}{"id": "id", "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1, "field1": nil},
 59 | 			},
 60 | 			wantErr: fmt.Errorf("field %s has unsupported type %T", "field1", nil),
 61 | 		},
 62 | 		{
 63 | 			name: "normal row with unsupported",
 64 | 			input: &Row{
 65 | 				Columns: []string{"id", "field1", "time", "value"},
 66 | 				Fields:  map[string]interface{}{"id": "id", "field1": struct{}{}, "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 67 | 			},
 68 | 			want: &Row{
 69 | 				Columns: []string{"id", "field1", "time", "value"},
 70 | 				Fields:  map[string]interface{}{"id": "id", "field1": struct{}{}, "time": time.UnixMilli(1257894000000).UTC(), "value": 0.1},
 71 | 			},
 72 | 			wantErr: fmt.Errorf("field %s has unsupported type %T", "field1", struct{}{}),
 73 | 		},
 74 | 		{
 75 | 			name: "normal row with multiple unsupported fields",
 76 | 			input: &Row{
 77 | 				Columns: []string{"field1", "id", "field2", "time", "field3", "value"},
 78 | 				Fields:  map[string]interface{}{"field1": struct{}{}, "id": "id", "field2": struct{}{}, "time": time.UnixMilli(1257894000000).UTC(), "field3": struct{}{}, "value": 0.1},
 79 | 			},
 80 | 			want: &Row{
 81 | 				Columns: []string{"field1", "id", "field2", "time", "field3", "value"},
 82 | 				Fields:  map[string]interface{}{"field1": struct{}{}, "id": "id", "field2": struct{}{}, "time": time.UnixMilli(1257894000000).UTC(), "field3": struct{}{}, "value": 0.1},
 83 | 			},
 84 | 			wantErr: fmt.Errorf("field %s has unsupported type %T", "field1", struct{}{}),
 85 | 		},
 86 | 		{
 87 | 			name: "normal row with conversion",
 88 | 			input: &Row{
 89 | 				Columns: []string{"field1", "id", "field2", "time", "field3", "value"},
 90 | 				Fields:  map[string]interface{}{"field1": gocql.UUID{}, "id": "id", "field2": net.ParseIP("127.0.0.1"), "time": time.UnixMilli(1257894000000).UTC(), "field3": []byte("some string"), "value": 0.1},
 91 | 			},
 92 | 			want: &Row{
 93 | 				Columns: []string{"field1", "id", "field2", "time", "field3", "value"},
 94 | 				Fields:  map[string]interface{}{"field1": "00000000-0000-0000-0000-000000000000", "id": "id", "field2": "127.0.0.1", "time": time.UnixMilli(1257894000000).UTC(), "field3": "some string", "value": 0.1},
 95 | 			},
 96 | 			wantErr: nil,
 97 | 		},
 98 | 	}
 99 | 
100 | 	for _, tc := range testCases {
101 | 		t.Run(tc.name, func(t *testing.T) {
102 | 			err := tc.input.normalize()
103 | 			if tc.wantErr == nil {
104 | 				assert.NoError(t, err)
105 | 			} else {
106 | 				assert.EqualError(t, err, tc.wantErr.Error())
107 | 			}
108 | 			assert.Equal(t, tc.want, tc.input)
109 | 		})
110 | 	}
111 | }
112 | 


--------------------------------------------------------------------------------
/backend/cassandra/session.go:
--------------------------------------------------------------------------------
  1 | package cassandra
  2 | 
  3 | import (
  4 | 	"context"
  5 | 	"crypto/tls"
  6 | 	"fmt"
  7 | 	"strings"
  8 | 	"time"
  9 | 
 10 | 	"github.com/gocql/gocql"
 11 | )
 12 | 
 13 | // Settings is a set of Cassandra session settings.
 14 | type Settings struct {
 15 | 	Hosts       []string
 16 | 	Keyspace    string
 17 | 	User        string
 18 | 	Password    string
 19 | 	Consistency string
 20 | 	Timeout     *int
 21 | 	TLSConfig   *tls.Config
 22 | }
 23 | 
 24 | // Session is a convenience wrapper for the gocql.Session.
 25 | type Session struct {
 26 | 	session *gocql.Session
 27 | }
 28 | 
 29 | // New creates a new cassandra cluster session using provided settings.
 30 | func New(cfg Settings) (*Session, error) {
 31 | 	cluster := gocql.NewCluster(cfg.Hosts...)
 32 | 	cluster.DisableInitialHostLookup = true // required, AWS specific
 33 | 	cluster.Keyspace = cfg.Keyspace
 34 | 
 35 | 	cluster.Authenticator = gocql.PasswordAuthenticator{
 36 | 		Username: cfg.User,
 37 | 		Password: cfg.Password,
 38 | 	}
 39 | 
 40 | 	consistencyLevel, err := gocql.ParseConsistencyWrapper(cfg.Consistency)
 41 | 	if err != nil {
 42 | 		return nil, fmt.Errorf("gocql.ParseConsistencyWrapper: %w", err)
 43 | 	}
 44 | 	cluster.Consistency = consistencyLevel
 45 | 
 46 | 	if cfg.Timeout != nil {
 47 | 		cluster.Timeout = time.Duration(*cfg.Timeout) * time.Second
 48 | 	}
 49 | 
 50 | 	if cfg.TLSConfig != nil {
 51 | 		cluster.SslOpts = &gocql.SslOptions{Config: cfg.TLSConfig}
 52 | 	}
 53 | 
 54 | 	clusterSession, err := cluster.CreateSession()
 55 | 	if err != nil {
 56 | 		return nil, fmt.Errorf("cluster.CreateSession: %w", err)
 57 | 	}
 58 | 
 59 | 	return &Session{clusterSession}, nil
 60 | }
 61 | 
 62 | // Select queries the database with provided query string and returns result rows grouped by ID.
 63 | // ID must be a first requested column in query and must be convertable to a string.
 64 | func (s *Session) Select(ctx context.Context, query string, values ...interface{}) (rows map[string][]Row, err error) {
 65 | 	if !isSelect(query) {
 66 | 		return nil, fmt.Errorf("query is not a SELECT statement: %s", query)
 67 | 	}
 68 | 
 69 | 	iter := s.session.Query(query, values...).WithContext(ctx).Iter()
 70 | 	defer func() {
 71 | 		if iterErr := iter.Close(); iterErr != nil {
 72 | 			err = fmt.Errorf("select query processing: %w", iterErr)
 73 | 		}
 74 | 	}()
 75 | 
 76 | 	rows = make(map[string][]Row)
 77 | 	for {
 78 | 		rowValues := make(map[string]interface{}, len(iter.Columns()))
 79 | 		if !iter.MapScan(rowValues) {
 80 | 			break
 81 | 		}
 82 | 
 83 | 		// first field is considered an id and used to distinguish different timeseries,
 84 | 		// so it must have string type. We are trying to convert id field value to
 85 | 		// a string or exit early in case when such conversion is not supported.
 86 | 		idFieldName := iter.Columns()[0].Name
 87 | 		id, err := toString(rowValues[idFieldName])
 88 | 		if err != nil {
 89 | 			return nil, fmt.Errorf("row processing: %w", err)
 90 | 		}
 91 | 
 92 | 		row := Row{
 93 | 			Columns: columnNames(iter.Columns()),
 94 | 			Fields:  rowValues,
 95 | 		}
 96 | 		if err := row.normalize(); err != nil {
 97 | 			return nil, fmt.Errorf("row.normalize: %w", err)
 98 | 		}
 99 | 		rows[id] = append(rows[id], row)
100 | 	}
101 | 
102 | 	return rows, nil
103 | }
104 | 
105 | // GetKeyspaces queries the cassandra cluster for a list of existing keyspaces.
106 | func (s *Session) GetKeyspaces(ctx context.Context) ([]string, error) {
107 | 	statement := "SELECT keyspace_name FROM system_schema.keyspaces"
108 | 	iter := s.session.Query(statement).WithContext(ctx).Iter()
109 | 
110 | 	var (
111 | 		keyspace  string
112 | 		keyspaces []string
113 | 	)
114 | 
115 | 	for iter.Scan(&keyspace) {
116 | 		keyspaces = append(keyspaces, keyspace)
117 | 	}
118 | 	if err := iter.Close(); err != nil {
119 | 		return nil, fmt.Errorf("query processing: %w", err)
120 | 	}
121 | 
122 | 	return keyspaces, nil
123 | }
124 | 
125 | // GetTables queries the cassandra cluster for a list of an existing tables in a given keyspace.
126 | func (s *Session) GetTables(keyspace string) ([]string, error) {
127 | 	keyspaceMetadata, err := s.session.KeyspaceMetadata(keyspace)
128 | 	if err != nil {
129 | 		return nil, fmt.Errorf("session.KeyspaceMetadata: %w", err)
130 | 	}
131 | 
132 | 	tables := make([]string, 0, len(keyspaceMetadata.Tables))
133 | 	for tableName := range keyspaceMetadata.Tables {
134 | 		tables = append(tables, tableName)
135 | 	}
136 | 
137 | 	return tables, nil
138 | }
139 | 
140 | // GetColumns queries the cassandra cluster for a list of an
141 | // existing columns of a given type for a given keyspace, table.
142 | func (s *Session) GetColumns(keyspace, table, needType string) ([]string, error) {
143 | 	keyspaceMetadata, err := s.session.KeyspaceMetadata(keyspace)
144 | 	if err != nil {
145 | 		return nil, fmt.Errorf("session.KeyspaceMetadata: %w", err)
146 | 	}
147 | 
148 | 	tableMetadata, ok := keyspaceMetadata.Tables[table]
149 | 	if !ok {
150 | 		return nil, fmt.Errorf("no such table: '%s'", table)
151 | 	}
152 | 
153 | 	columns := make([]string, 0, len(tableMetadata.Columns))
154 | 	for name, column := range tableMetadata.Columns {
155 | 		if column.Type.Type().String() == needType {
156 | 			columns = append(columns, name)
157 | 		}
158 | 	}
159 | 
160 | 	return columns, nil
161 | }
162 | 
163 | // Ping executes a simple query to check the connection status.
164 | func (s *Session) Ping(ctx context.Context) error {
165 | 	err := s.session.Query("SELECT key FROM system.local").WithContext(ctx).Exec()
166 | 	if err != nil {
167 | 		return fmt.Errorf("session.Query: %w", err)
168 | 	}
169 | 
170 | 	return nil
171 | }
172 | 
173 | // Close closes connections to cluster.
174 | func (s *Session) Close() {
175 | 	s.session.Close()
176 | }
177 | 
178 | func isSelect(query string) bool {
179 | 	stmt := strings.TrimSpace(query)
180 | 	if !strings.HasPrefix(strings.ToUpper(stmt), "SELECT ") {
181 | 		return false
182 | 	}
183 | 
184 | 	return true
185 | }
186 | 
187 | func toString(val interface{}) (string, error) {
188 | 	var str string
189 | 	switch v := val.(type) {
190 | 	case string:
191 | 		str = v
192 | 	case gocql.UUID:
193 | 		str = v.String()
194 | 	case int8, int32, int64, int:
195 | 		str = fmt.Sprintf("%d", v)
196 | 	case float32, float64:
197 | 		str = fmt.Sprintf("%f", v)
198 | 	case time.Time:
199 | 		str = v.String()
200 | 	case bool:
201 | 		str = fmt.Sprintf("%t", v)
202 | 	default:
203 | 		return "", fmt.Errorf("unsupported type: %T", val)
204 | 	}
205 | 
206 | 	return str, nil
207 | }
208 | 
209 | func columnNames(columnInfo []gocql.ColumnInfo) []string {
210 | 	names := make([]string, 0, len(columnInfo))
211 | 	for _, col := range columnInfo {
212 | 		names = append(names, col.Name)
213 | 	}
214 | 
215 | 	return names
216 | }
217 | 


--------------------------------------------------------------------------------
/backend/cassandra/session_test.go:
--------------------------------------------------------------------------------
  1 | package cassandra
  2 | 
  3 | import (
  4 | 	"fmt"
  5 | 	"testing"
  6 | 
  7 | 	"github.com/gocql/gocql"
  8 | 	"github.com/stretchr/testify/assert"
  9 | )
 10 | 
 11 | func Test_toString(t *testing.T) {
 12 | 	testCases := []struct {
 13 | 		name    string
 14 | 		input   interface{}
 15 | 		want    string
 16 | 		wantErr error
 17 | 	}{
 18 | 		{
 19 | 			name:    "string",
 20 | 			input:   "00000000-0000-0000-0000-000000000000",
 21 | 			want:    "00000000-0000-0000-0000-000000000000",
 22 | 			wantErr: nil,
 23 | 		},
 24 | 		{
 25 | 			name:    "UUID",
 26 | 			input:   gocql.UUID{},
 27 | 			want:    "00000000-0000-0000-0000-000000000000",
 28 | 			wantErr: nil,
 29 | 		},
 30 | 		{
 31 | 			name:    "int64",
 32 | 			input:   int64(123),
 33 | 			want:    "123",
 34 | 			wantErr: nil,
 35 | 		},
 36 | 		{
 37 | 			name:    "float64",
 38 | 			input:   float64(0.1),
 39 | 			want:    "0.100000",
 40 | 			wantErr: nil,
 41 | 		},
 42 | 		{
 43 | 			name:    "bool",
 44 | 			input:   true,
 45 | 			want:    "true",
 46 | 			wantErr: nil,
 47 | 		},
 48 | 		{
 49 | 			name:    "unsupported",
 50 | 			input:   struct{}{},
 51 | 			want:    "",
 52 | 			wantErr: fmt.Errorf("unsupported type: %T", struct{}{}),
 53 | 		},
 54 | 	}
 55 | 
 56 | 	for _, tc := range testCases {
 57 | 		t.Run(tc.name, func(t *testing.T) {
 58 | 			val, err := toString(tc.input)
 59 | 			if tc.wantErr == nil {
 60 | 				assert.NoError(t, err)
 61 | 			} else {
 62 | 				assert.EqualError(t, err, tc.wantErr.Error())
 63 | 			}
 64 | 			assert.Equal(t, tc.want, val)
 65 | 		})
 66 | 	}
 67 | }
 68 | 
 69 | func Test_isSelect(t *testing.T) {
 70 | 	testCases := []struct {
 71 | 		name  string
 72 | 		input string
 73 | 		want  bool
 74 | 	}{
 75 | 		{
 76 | 			name:  "empty string",
 77 | 			input: "",
 78 | 			want:  false,
 79 | 		},
 80 | 		{
 81 | 			name:  "select string low",
 82 | 			input: "select * from table;",
 83 | 			want:  true,
 84 | 		},
 85 | 		{
 86 | 			name:  "select string up",
 87 | 			input: "SELECT * from table;",
 88 | 			want:  true,
 89 | 		},
 90 | 		{
 91 | 			name:  "insert string",
 92 | 			input: "insert into table (id) values ('test');",
 93 | 			want:  false,
 94 | 		},
 95 | 		{
 96 | 			name:  "delete string",
 97 | 			input: "delete from table where id = 'test';",
 98 | 			want:  false,
 99 | 		},
100 | 		{
101 | 			name:  "delete string with column",
102 | 			input: "delete column from table where id = 'test';",
103 | 			want:  false,
104 | 		},
105 | 		{
106 | 			name:  "drop table string",
107 | 			input: "drop table test;",
108 | 			want:  false,
109 | 		},
110 | 		{
111 | 			name:  "truncate string",
112 | 			input: "truncate table test;",
113 | 			want:  false,
114 | 		},
115 | 		{
116 | 			name:  "drop keyspace string",
117 | 			input: "drop keyspace test;",
118 | 			want:  false,
119 | 		},
120 | 	}
121 | 
122 | 	for _, tc := range testCases {
123 | 		t.Run(tc.name, func(t *testing.T) {
124 | 			result := isSelect(tc.input)
125 | 			assert.Equal(t, tc.want, result)
126 | 		})
127 | 	}
128 | }
129 | 


--------------------------------------------------------------------------------
/backend/go.mod:
--------------------------------------------------------------------------------
  1 | module github.com/HadesArchitect/GrafanaCassandraDatasource/backend
  2 | 
  3 | go 1.24.3
  4 | 
  5 | require (
  6 | 	github.com/gocql/gocql v1.7.0
  7 | 	github.com/grafana/grafana-plugin-sdk-go v0.277.1
  8 | 	github.com/stretchr/testify v1.10.0
  9 | )
 10 | 
 11 | require (
 12 | 	github.com/BurntSushi/toml v1.5.0 // indirect
 13 | 	github.com/apache/arrow-go/v18 v18.3.0 // indirect
 14 | 	github.com/beorn7/perks v1.0.1 // indirect
 15 | 	github.com/cenkalti/backoff/v5 v5.0.2 // indirect
 16 | 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 17 | 	github.com/cheekybits/genny v1.0.0 // indirect
 18 | 	github.com/chromedp/cdproto v0.0.0-20250527225801-8f9bc3ce9e31 // indirect
 19 | 	github.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect
 20 | 	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
 21 | 	github.com/elazarl/goproxy v1.7.2 // indirect
 22 | 	github.com/fatih/color v1.18.0 // indirect
 23 | 	github.com/getkin/kin-openapi v0.132.0 // indirect
 24 | 	github.com/go-logr/logr v1.4.3 // indirect
 25 | 	github.com/go-logr/stdr v1.2.2 // indirect
 26 | 	github.com/go-openapi/jsonpointer v0.21.1 // indirect
 27 | 	github.com/go-openapi/swag v0.23.1 // indirect
 28 | 	github.com/goccy/go-json v0.10.5 // indirect
 29 | 	github.com/gogo/googleapis v1.4.1 // indirect
 30 | 	github.com/gogo/protobuf v1.3.2 // indirect
 31 | 	github.com/golang/protobuf v1.5.4 // indirect
 32 | 	github.com/golang/snappy v1.0.0 // indirect
 33 | 	github.com/google/flatbuffers v25.2.10+incompatible // indirect
 34 | 	github.com/google/go-cmp v0.7.0 // indirect
 35 | 	github.com/google/uuid v1.6.0 // indirect
 36 | 	github.com/gorilla/mux v1.8.1 // indirect
 37 | 	github.com/grafana/otel-profiling-go v0.5.1 // indirect
 38 | 	github.com/grafana/pyroscope-go/godeltaprof v0.1.8 // indirect
 39 | 	github.com/grpc-ecosystem/go-grpc-middleware/providers/prometheus v1.0.1 // indirect
 40 | 	github.com/grpc-ecosystem/go-grpc-middleware/v2 v2.3.2 // indirect
 41 | 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.26.3 // indirect
 42 | 	github.com/hailocab/go-hostpool v0.0.0-20160125115350-e80d13ce29ed // indirect
 43 | 	github.com/hashicorp/go-hclog v1.6.3 // indirect
 44 | 	github.com/hashicorp/go-plugin v1.6.3 // indirect
 45 | 	github.com/hashicorp/yamux v0.1.2 // indirect
 46 | 	github.com/jaegertracing/jaeger-idl v0.6.0 // indirect
 47 | 	github.com/josharian/intern v1.0.0 // indirect
 48 | 	github.com/json-iterator/go v1.1.12 // indirect
 49 | 	github.com/klauspost/compress v1.18.0 // indirect
 50 | 	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
 51 | 	github.com/magefile/mage v1.15.0 // indirect
 52 | 	github.com/mailru/easyjson v0.9.0 // indirect
 53 | 	github.com/mattetti/filebuffer v1.0.1 // indirect
 54 | 	github.com/mattn/go-colorable v0.1.14 // indirect
 55 | 	github.com/mattn/go-isatty v0.0.20 // indirect
 56 | 	github.com/mattn/go-runewidth v0.0.16 // indirect
 57 | 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 58 | 	github.com/modern-go/reflect2 v1.0.2 // indirect
 59 | 	github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826 // indirect
 60 | 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
 61 | 	github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 // indirect
 62 | 	github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 // indirect
 63 | 	github.com/oklog/run v1.1.0 // indirect
 64 | 	github.com/olekukonko/tablewriter v0.0.5 // indirect
 65 | 	github.com/perimeterx/marshmallow v1.1.5 // indirect
 66 | 	github.com/pierrec/lz4/v4 v4.1.22 // indirect
 67 | 	github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
 68 | 	github.com/prometheus/client_golang v1.22.0 // indirect
 69 | 	github.com/prometheus/client_model v0.6.2 // indirect
 70 | 	github.com/prometheus/common v0.64.0 // indirect
 71 | 	github.com/prometheus/procfs v0.16.1 // indirect
 72 | 	github.com/rivo/uniseg v0.4.7 // indirect
 73 | 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
 74 | 	github.com/unknwon/bra v0.0.0-20200517080246-1e3013ecaff8 // indirect
 75 | 	github.com/unknwon/com v1.0.1 // indirect
 76 | 	github.com/unknwon/log v0.0.0-20200308114134-929b1006e34a // indirect
 77 | 	github.com/urfave/cli v1.22.16 // indirect
 78 | 	github.com/zeebo/xxh3 v1.0.2 // indirect
 79 | 	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
 80 | 	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.61.0 // indirect
 81 | 	go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.61.0 // indirect
 82 | 	go.opentelemetry.io/contrib/propagators/jaeger v1.36.0 // indirect
 83 | 	go.opentelemetry.io/contrib/samplers/jaegerremote v0.30.0 // indirect
 84 | 	go.opentelemetry.io/otel v1.36.0 // indirect
 85 | 	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.36.0 // indirect
 86 | 	go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.36.0 // indirect
 87 | 	go.opentelemetry.io/otel/metric v1.36.0 // indirect
 88 | 	go.opentelemetry.io/otel/sdk v1.36.0 // indirect
 89 | 	go.opentelemetry.io/otel/trace v1.36.0 // indirect
 90 | 	go.opentelemetry.io/proto/otlp v1.6.0 // indirect
 91 | 	golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6 // indirect
 92 | 	golang.org/x/mod v0.24.0 // indirect
 93 | 	golang.org/x/net v0.40.0 // indirect
 94 | 	golang.org/x/sync v0.14.0 // indirect
 95 | 	golang.org/x/sys v0.33.0 // indirect
 96 | 	golang.org/x/text v0.25.0 // indirect
 97 | 	golang.org/x/tools v0.33.0 // indirect
 98 | 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
 99 | 	google.golang.org/genproto/googleapis/api v0.0.0-20250528174236-200df99c418a // indirect
100 | 	google.golang.org/genproto/googleapis/rpc v0.0.0-20250528174236-200df99c418a // indirect
101 | 	google.golang.org/grpc v1.72.2 // indirect
102 | 	google.golang.org/protobuf v1.36.6 // indirect
103 | 	gopkg.in/fsnotify/fsnotify.v1 v1.4.7 // indirect
104 | 	gopkg.in/inf.v0 v0.9.1 // indirect
105 | 	gopkg.in/yaml.v3 v3.0.1 // indirect
106 | )
107 | 


--------------------------------------------------------------------------------
/backend/handler/data_query.go:
--------------------------------------------------------------------------------
 1 | package handler
 2 | 
 3 | import (
 4 | 	"encoding/json"
 5 | 	"fmt"
 6 | 	"regexp"
 7 | 	"time"
 8 | 
 9 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/plugin"
10 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
11 | )
12 | 
13 | var (
14 | 	timeFromRegexp      = regexp.MustCompile(`\$__timeFrom`)
15 | 	timeToRegexp        = regexp.MustCompile(`\$__timeTo`)
16 | 	unixEpochFromRegexp = regexp.MustCompile(`\$__unixEpochFrom`)
17 | 	unixEpochToRegexp   = regexp.MustCompile(`\$__unixEpochTo`)
18 | )
19 | 
20 | const (
21 | 	queryTypeQuery = "query"
22 | 	queryTypeAlert = "alert"
23 | )
24 | 
25 | type dataQuery struct {
26 | 	DatasourceID int    `json:"datasourceId"`
27 | 	QueryType    string `json:"queryType"`
28 | 	RawQuery     bool   `json:"rawQuery"`
29 | 	RefID        string `json:"refId"`
30 | 	Target       string `json:"target"`
31 | 
32 | 	ColumnTime     string `json:"columnTime"`
33 | 	ColumnValue    string `json:"columnValue"`
34 | 	Keyspace       string `json:"keyspace"`
35 | 	Table          string `json:"table"`
36 | 	ColumnID       string `json:"columnId"`
37 | 	ValueID        string `json:"valueId"`
38 | 	Alias          string `json:"alias,omitempty"`
39 | 	AllowFiltering bool   `json:"filtering,omitempty"`
40 | 	Instant        bool   `json:"instant,omitempty"`
41 | }
42 | 
43 | // parseDataQuery is a simple helper to unmarshal
44 | // backend.DataQuery's JSON into the cassandra.Query type.
45 | func parseDataQuery(q *backend.DataQuery) (*plugin.Query, error) {
46 | 	var dq dataQuery
47 | 	err := json.Unmarshal(q.JSON, &dq)
48 | 	if err != nil {
49 | 		return nil, fmt.Errorf("json.Unmarshal: %w", err)
50 | 	}
51 | 
52 | 	if dq.RawQuery {
53 | 		dq.applyTimeRange(q.TimeRange.From, q.TimeRange.To)
54 | 	}
55 | 
56 | 	return &plugin.Query{
57 | 		RawQuery:       dq.RawQuery,
58 | 		Target:         dq.Target,
59 | 		Keyspace:       dq.Keyspace,
60 | 		Table:          dq.Table,
61 | 		ColumnValue:    dq.ColumnValue,
62 | 		ColumnID:       dq.ColumnID,
63 | 		ValueID:        dq.ValueID,
64 | 		AliasID:        dq.Alias,
65 | 		ColumnTime:     dq.ColumnTime,
66 | 		TimeFrom:       q.TimeRange.From,
67 | 		TimeTo:         q.TimeRange.To,
68 | 		AllowFiltering: dq.AllowFiltering,
69 | 		Instant:        dq.Instant,
70 | 		IsAlertQuery:   dq.QueryType == queryTypeAlert,
71 | 	}, nil
72 | }
73 | 
74 | func (dq *dataQuery) applyTimeRange(from time.Time, to time.Time) {
75 | 	query := []byte(dq.Target)
76 | 	query = timeFromRegexp.ReplaceAll(query, []byte(fmt.Sprintf("%d", from.UnixMilli())))
77 | 	query = timeToRegexp.ReplaceAll(query, []byte(fmt.Sprintf("%d", to.UnixMilli())))
78 | 	query = unixEpochFromRegexp.ReplaceAll(query, []byte(fmt.Sprintf("%d", from.Unix())))
79 | 	query = unixEpochToRegexp.ReplaceAll(query, []byte(fmt.Sprintf("%d", to.Unix())))
80 | 
81 | 	dq.Target = string(query)
82 | }
83 | 


--------------------------------------------------------------------------------
/backend/handler/data_query_test.go:
--------------------------------------------------------------------------------
  1 | package handler
  2 | 
  3 | import (
  4 | 	"testing"
  5 | 	"time"
  6 | 
  7 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/plugin"
  8 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
  9 | 	"github.com/stretchr/testify/assert"
 10 | )
 11 | 
 12 | func Test_parseDataQuery(t *testing.T) {
 13 | 	testCases := []struct {
 14 | 		name      string
 15 | 		timeRange backend.TimeRange
 16 | 		jsonStr   []byte
 17 | 		want      *plugin.Query
 18 | 	}{
 19 | 		{
 20 | 			name:      "all fields",
 21 | 			timeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(1257894010, 0)},
 22 | 			jsonStr: []byte(`{"datasourceId": 1, "queryType": "query", "rawQuery": true, "refId": "123456789",
 23 | 							  "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
 24 | 							  "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "123",
 25 | 							  "alias": "Alias", "filtering": true, "instant": true}`),
 26 | 			want: &plugin.Query{
 27 | 				RawQuery:       true,
 28 | 				Target:         "SELECT * from Keyspace.Table",
 29 | 				Keyspace:       "Keyspace",
 30 | 				Table:          "Table",
 31 | 				ColumnValue:    "Value",
 32 | 				ColumnID:       "ID",
 33 | 				ValueID:        "123",
 34 | 				AliasID:        "Alias",
 35 | 				ColumnTime:     "Time",
 36 | 				TimeFrom:       time.Unix(1257894000, 0),
 37 | 				TimeTo:         time.Unix(1257894010, 0),
 38 | 				AllowFiltering: true,
 39 | 				Instant:        true,
 40 | 			},
 41 | 		},
 42 | 		{
 43 | 			name:      "no optional fields",
 44 | 			timeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(1257894010, 0)},
 45 | 			jsonStr: []byte(`{"datasourceId": 1, "queryType": "query", "rawQuery": true, "refId": "123456789",
 46 | 					   		  "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
 47 | 					   		  "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "123"}`),
 48 | 			want: &plugin.Query{
 49 | 				RawQuery:       true,
 50 | 				Target:         "SELECT * from Keyspace.Table",
 51 | 				Keyspace:       "Keyspace",
 52 | 				Table:          "Table",
 53 | 				ColumnValue:    "Value",
 54 | 				ColumnID:       "ID",
 55 | 				ValueID:        "123",
 56 | 				AliasID:        "",
 57 | 				ColumnTime:     "Time",
 58 | 				TimeFrom:       time.Unix(1257894000, 0),
 59 | 				TimeTo:         time.Unix(1257894010, 0),
 60 | 				AllowFiltering: false,
 61 | 				Instant:        false,
 62 | 			},
 63 | 		},
 64 | 		{
 65 | 			name:      "alert query",
 66 | 			timeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(1257894010, 0)},
 67 | 			jsonStr: []byte(`{"datasourceId": 1, "queryType": "alert", "rawQuery": true, "refId": "123456789",
 68 | 					   		  "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
 69 | 					   		  "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "123"}`),
 70 | 			want: &plugin.Query{
 71 | 				RawQuery:       true,
 72 | 				Target:         "SELECT * from Keyspace.Table",
 73 | 				Keyspace:       "Keyspace",
 74 | 				Table:          "Table",
 75 | 				ColumnValue:    "Value",
 76 | 				ColumnID:       "ID",
 77 | 				ValueID:        "123",
 78 | 				AliasID:        "",
 79 | 				ColumnTime:     "Time",
 80 | 				TimeFrom:       time.Unix(1257894000, 0),
 81 | 				TimeTo:         time.Unix(1257894010, 0),
 82 | 				AllowFiltering: false,
 83 | 				Instant:        false,
 84 | 				IsAlertQuery:   true,
 85 | 			},
 86 | 		},
 87 | 	}
 88 | 
 89 | 	for _, tc := range testCases {
 90 | 		t.Run(tc.name, func(t *testing.T) {
 91 | 			query, err := parseDataQuery(&backend.DataQuery{TimeRange: tc.timeRange, JSON: tc.jsonStr})
 92 | 			if err != nil {
 93 | 				t.Fatalf("parseDataQuery: %v", err)
 94 | 			}
 95 | 
 96 | 			assert.Equal(t, tc.want, query)
 97 | 		})
 98 | 	}
 99 | }
100 | 


--------------------------------------------------------------------------------
/backend/handler/handler.go:
--------------------------------------------------------------------------------
  1 | package handler
  2 | 
  3 | import (
  4 | 	"context"
  5 | 	"encoding/json"
  6 | 	"fmt"
  7 | 	"net/http"
  8 | 
  9 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/plugin"
 10 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
 11 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/datasource"
 12 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/instancemgmt"
 13 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/resource/httpadapter"
 14 | 	"github.com/grafana/grafana-plugin-sdk-go/data"
 15 | )
 16 | 
 17 | type ds interface {
 18 | 	ExecQuery(ctx context.Context, q *plugin.Query) (data.Frames, error)
 19 | 	GetKeyspaces(ctx context.Context) ([]string, error)
 20 | 	GetTables(keyspace string) ([]string, error)
 21 | 	GetColumns(keyspace, table, needType string) ([]string, error)
 22 | 	GetVariables(ctx context.Context, query string) ([]plugin.Variable, error)
 23 | 	CheckHealth(ctx context.Context) error
 24 | 	Dispose()
 25 | }
 26 | 
 27 | // handler controls plugin instance manager and handles requests.
 28 | type handler struct {
 29 | 	instanceManager instancemgmt.InstanceManager
 30 | }
 31 | 
 32 | // New initializes plugin instance, http multiplexers, and sets http request handlers.
 33 | func New(fn datasource.InstanceFactoryFunc) datasource.ServeOpts {
 34 | 	h := &handler{instanceManager: datasource.NewInstanceManager(fn)}
 35 | 
 36 | 	// CallResourceHandler
 37 | 	mux := http.NewServeMux()
 38 | 	mux.HandleFunc("/keyspaces", h.getKeyspaces)
 39 | 	mux.HandleFunc("/tables", h.getTables)
 40 | 	mux.HandleFunc("/columns", h.getColumns)
 41 | 	mux.HandleFunc("/variables", h.getVariables)
 42 | 
 43 | 	// QueryDataHandler
 44 | 	queryTypeMux := datasource.NewQueryTypeMux()
 45 | 	queryTypeMux.HandleFunc("query", h.queryMetricData)
 46 | 	queryTypeMux.HandleFunc("alert", h.queryMetricData)
 47 | 
 48 | 	return datasource.ServeOpts{
 49 | 		CheckHealthHandler:  h,
 50 | 		CallResourceHandler: httpadapter.New(mux),
 51 | 		QueryDataHandler:    queryTypeMux,
 52 | 	}
 53 | }
 54 | 
 55 | // queryMetricData is a handle to process metric requests.
 56 | func (h *handler) queryMetricData(ctx context.Context, req *backend.QueryDataRequest) (*backend.QueryDataResponse, error) {
 57 | 	p, err := h.getPluginInstance(ctx, req.PluginContext)
 58 | 	if err != nil {
 59 | 		backend.Logger.Error("Failed to get plugin instance", "Message", err)
 60 | 		return nil, fmt.Errorf("failed to get plugin instance: %w", err)
 61 | 	}
 62 | 
 63 | 	responses := backend.Responses{}
 64 | 	for _, q := range req.Queries {
 65 | 		backend.Logger.Debug("Process metrics request", "Request", q.JSON)
 66 | 		cassQuery, err := parseDataQuery(&q)
 67 | 		if err != nil {
 68 | 			backend.Logger.Error("Failed to parse query", "Message", err)
 69 | 			responses[q.RefID] = backend.DataResponse{Error: fmt.Errorf("json.Unmarshal: %w", err)}
 70 | 			continue
 71 | 		}
 72 | 
 73 | 		dataFrames, err := p.ExecQuery(ctx, cassQuery)
 74 | 		if err != nil {
 75 | 			backend.Logger.Error("Failed to execute query", "Message", err)
 76 | 			responses[q.RefID] = backend.DataResponse{Error: fmt.Errorf("p.ExecQuery: %w", err)}
 77 | 			continue
 78 | 		}
 79 | 
 80 | 		responses[q.RefID] = backend.DataResponse{Frames: dataFrames}
 81 | 	}
 82 | 
 83 | 	return &backend.QueryDataResponse{Responses: responses}, nil
 84 | }
 85 | 
 86 | // getKeyspaces is a handle to fetch keyspaces list.
 87 | func (h *handler) getKeyspaces(rw http.ResponseWriter, req *http.Request) {
 88 | 	backend.Logger.Debug("Process 'keyspaces' request")
 89 | 
 90 | 	pluginCtx := httpadapter.PluginConfigFromContext(req.Context())
 91 | 	p, err := h.getPluginInstance(req.Context(), pluginCtx)
 92 | 	if err != nil {
 93 | 		backend.Logger.Error("Failed to get plugin instance", "Message", err)
 94 | 		rw.WriteHeader(http.StatusInternalServerError)
 95 | 		return
 96 | 	}
 97 | 
 98 | 	keyspaces, err := p.GetKeyspaces(req.Context())
 99 | 	if err != nil {
100 | 		backend.Logger.Error("Failed to get keyspaces list", "Message", err)
101 | 		rw.WriteHeader(http.StatusInternalServerError)
102 | 		return
103 | 	}
104 | 
105 | 	writeHTTPResult(rw, keyspaces)
106 | }
107 | 
108 | // getTables is a handle to fetch tables list.
109 | func (h *handler) getTables(rw http.ResponseWriter, req *http.Request) {
110 | 	backend.Logger.Debug("Process 'tables' request")
111 | 
112 | 	pluginCtx := httpadapter.PluginConfigFromContext(req.Context())
113 | 	p, err := h.getPluginInstance(req.Context(), pluginCtx)
114 | 	if err != nil {
115 | 		backend.Logger.Error("Failed to get plugin instance", "Message", err)
116 | 		rw.WriteHeader(http.StatusInternalServerError)
117 | 		return
118 | 	}
119 | 
120 | 	keyspace := req.URL.Query().Get("keyspace")
121 | 
122 | 	tables, err := p.GetTables(keyspace)
123 | 	if err != nil {
124 | 		backend.Logger.Error("Failed to get tables list", "Message", err)
125 | 		rw.WriteHeader(http.StatusInternalServerError)
126 | 		return
127 | 	}
128 | 
129 | 	writeHTTPResult(rw, tables)
130 | }
131 | 
132 | // getColumns is a handle to fetch columns list.
133 | func (h *handler) getColumns(rw http.ResponseWriter, req *http.Request) {
134 | 	backend.Logger.Debug("Process 'columns' request")
135 | 
136 | 	pluginCtx := httpadapter.PluginConfigFromContext(req.Context())
137 | 	p, err := h.getPluginInstance(req.Context(), pluginCtx)
138 | 	if err != nil {
139 | 		backend.Logger.Error("Failed to get plugin instance", "Message", err)
140 | 		rw.WriteHeader(http.StatusInternalServerError)
141 | 		return
142 | 	}
143 | 
144 | 	keyspace := req.URL.Query().Get("keyspace")
145 | 	table := req.URL.Query().Get("table")
146 | 	needType := req.URL.Query().Get("needType")
147 | 
148 | 	columns, err := p.GetColumns(keyspace, table, needType)
149 | 	if err != nil {
150 | 		backend.Logger.Error("Failed to get columns list", "Message", err)
151 | 		rw.WriteHeader(http.StatusInternalServerError)
152 | 		return
153 | 	}
154 | 
155 | 	writeHTTPResult(rw, columns)
156 | }
157 | 
158 | // getVariables is a handle to fetch variable values.
159 | func (h *handler) getVariables(rw http.ResponseWriter, req *http.Request) {
160 | 	backend.Logger.Debug("Process 'variables' request")
161 | 
162 | 	pluginCtx := httpadapter.PluginConfigFromContext(req.Context())
163 | 	p, err := h.getPluginInstance(req.Context(), pluginCtx)
164 | 	if err != nil {
165 | 		backend.Logger.Error("Failed to get plugin instance", "Message", err)
166 | 		rw.WriteHeader(http.StatusInternalServerError)
167 | 		return
168 | 	}
169 | 
170 | 	query := req.URL.Query().Get("query")
171 | 
172 | 	variables, err := p.GetVariables(req.Context(), query)
173 | 	if err != nil {
174 | 		backend.Logger.Error("Failed to get variables", "Message", err)
175 | 		rw.WriteHeader(http.StatusInternalServerError)
176 | 		return
177 | 	}
178 | 
179 | 	writeHTTPResult(rw, variables)
180 | }
181 | 
182 | // getPluginInstance fetches plugin instance from instance manager, then
183 | // returns it if it has been successfully asserted that it is a plugin type.
184 | func (h *handler) getPluginInstance(ctx context.Context, pluginCtx backend.PluginContext) (ds, error) {
185 | 	instance, err := h.instanceManager.Get(ctx, pluginCtx)
186 | 	if err != nil {
187 | 		return nil, fmt.Errorf("instanceManager.Get: %w", err)
188 | 	}
189 | 
190 | 	p, ok := instance.(ds)
191 | 	if !ok {
192 | 		return nil, fmt.Errorf("invalid instance type: %T", instance)
193 | 	}
194 | 
195 | 	return p, nil
196 | }
197 | 
198 | // CheckHealth is a handle to check database connection status.
199 | func (h *handler) CheckHealth(ctx context.Context, req *backend.CheckHealthRequest) (*backend.CheckHealthResult, error) {
200 | 	p, err := h.getPluginInstance(ctx, req.PluginContext)
201 | 	if err != nil {
202 | 		return &backend.CheckHealthResult{
203 | 			Status:  backend.HealthStatusUnknown,
204 | 			Message: "Error, check Grafana logs for more details",
205 | 		}, nil
206 | 	}
207 | 
208 | 	err = p.CheckHealth(ctx)
209 | 	if err != nil {
210 | 		backend.Logger.Error("Failed to connect to server", "Message", err)
211 | 		return &backend.CheckHealthResult{
212 | 			Status:  backend.HealthStatusError,
213 | 			Message: "Error, check Grafana logs for more details",
214 | 		}, nil
215 | 	}
216 | 
217 | 	return &backend.CheckHealthResult{
218 | 		Status:  backend.HealthStatusOk,
219 | 		Message: "Connected",
220 | 	}, nil
221 | }
222 | 
223 | // writeHTTPResult is a simple helper to serialize data and put it in a http response.
224 | func writeHTTPResult(rw http.ResponseWriter, val any) {
225 | 	jsonBytes, err := json.MarshalIndent(val, "", "    ")
226 | 	if err != nil {
227 | 		backend.Logger.Error("Failed to marshal list", "Message", err)
228 | 		rw.WriteHeader(http.StatusInternalServerError)
229 | 		return
230 | 	}
231 | 
232 | 	_, err = rw.Write(jsonBytes)
233 | 	if err != nil {
234 | 		backend.Logger.Error("Failed to write response", "Message", err)
235 | 		rw.WriteHeader(http.StatusInternalServerError)
236 | 		return
237 | 	}
238 | 
239 | 	rw.WriteHeader(http.StatusOK)
240 | }
241 | 


--------------------------------------------------------------------------------
/backend/handler/handler_test.go:
--------------------------------------------------------------------------------
  1 | package handler
  2 | 
  3 | import (
  4 | 	"context"
  5 | 	"errors"
  6 | 	"net/http"
  7 | 	"net/http/httptest"
  8 | 	"testing"
  9 | 	"time"
 10 | 
 11 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/plugin"
 12 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
 13 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/instancemgmt"
 14 | 	"github.com/grafana/grafana-plugin-sdk-go/data"
 15 | 	"github.com/stretchr/testify/assert"
 16 | )
 17 | 
 18 | type instanceManagerMock struct {
 19 | 	plugin *pluginMock
 20 | }
 21 | 
 22 | func (i *instanceManagerMock) Get(_ context.Context, _ backend.PluginContext) (instancemgmt.Instance, error) {
 23 | 	return i.plugin, nil
 24 | }
 25 | 
 26 | func (i *instanceManagerMock) Do(_ context.Context, _ backend.PluginContext, _ instancemgmt.InstanceCallbackFunc) error {
 27 | 	return nil
 28 | }
 29 | 
 30 | type pluginMock struct {
 31 | 	onExecQuery    func(ctx context.Context, q *plugin.Query) (data.Frames, error)
 32 | 	onGetKeyspaces func(ctx context.Context) ([]string, error)
 33 | 	onGetTables    func(keyspace string) ([]string, error)
 34 | 	onGetColumns   func(keyspace, table, needType string) ([]string, error)
 35 | 	onGetVariables func(ctx context.Context, query string) ([]plugin.Variable, error)
 36 | 	onCheckHealth  func(ctx context.Context) error
 37 | 	onDispose      func()
 38 | }
 39 | 
 40 | func (p *pluginMock) ExecQuery(ctx context.Context, q *plugin.Query) (data.Frames, error) {
 41 | 	return p.onExecQuery(ctx, q)
 42 | }
 43 | 
 44 | func (p *pluginMock) GetKeyspaces(ctx context.Context) ([]string, error) {
 45 | 	return p.onGetKeyspaces(ctx)
 46 | }
 47 | 
 48 | func (p *pluginMock) GetTables(keyspace string) ([]string, error) {
 49 | 	return p.onGetTables(keyspace)
 50 | }
 51 | 
 52 | func (p *pluginMock) GetColumns(keyspace, table, needType string) ([]string, error) {
 53 | 	return p.onGetColumns(keyspace, table, needType)
 54 | }
 55 | 
 56 | func (p *pluginMock) GetVariables(ctx context.Context, query string) ([]plugin.Variable, error) {
 57 | 	return p.onGetVariables(ctx, query)
 58 | }
 59 | 
 60 | func (p *pluginMock) CheckHealth(ctx context.Context) error {
 61 | 	return p.onCheckHealth(ctx)
 62 | }
 63 | 
 64 | func (p *pluginMock) Dispose() {}
 65 | 
 66 | func Test_queryMetricData(t *testing.T) {
 67 | 	testCases := []struct {
 68 | 		name    string
 69 | 		plugin  *pluginMock
 70 | 		request *backend.QueryDataRequest
 71 | 		want    *backend.QueryDataResponse
 72 | 	}{
 73 | 		{
 74 | 			name:    "empty",
 75 | 			plugin:  &pluginMock{},
 76 | 			request: &backend.QueryDataRequest{},
 77 | 			want:    &backend.QueryDataResponse{Responses: backend.Responses{}},
 78 | 		},
 79 | 		{
 80 | 			name: "one query",
 81 | 			plugin: &pluginMock{
 82 | 				onExecQuery: func(_ context.Context, q *plugin.Query) (data.Frames, error) {
 83 | 					return data.Frames{{
 84 | 						Name: "1",
 85 | 						Fields: []*data.Field{
 86 | 							data.NewField("time", nil, []time.Time{time.Unix(1257894000, 0)}),
 87 | 							data.NewField("1", nil, []float64{3.141}).SetConfig(&data.FieldConfig{DisplayNameFromDS: "Alias"}),
 88 | 						}},
 89 | 					}, nil
 90 | 				},
 91 | 			},
 92 | 			request: &backend.QueryDataRequest{
 93 | 				Queries: []backend.DataQuery{
 94 | 					{
 95 | 						RefID:     "123456789",
 96 | 						TimeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(125789403, 0)},
 97 | 						JSON: []byte(`{"datasourceId": 1, "queryType": "query", "rawQuery": true, "refId": "123456789",
 98 | 							        "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
 99 | 								    "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "1",
100 | 									"alias": "Alias", "filtering": true}`),
101 | 					},
102 | 				},
103 | 			},
104 | 			want: &backend.QueryDataResponse{Responses: backend.Responses{
105 | 				"123456789": backend.DataResponse{
106 | 					Frames: data.Frames{{
107 | 						Name: "1",
108 | 						Fields: []*data.Field{
109 | 							data.NewField("time", nil, []time.Time{time.Unix(1257894000, 0)}),
110 | 							data.NewField("1", nil, []float64{3.141}).SetConfig(&data.FieldConfig{DisplayNameFromDS: "Alias"}),
111 | 						}},
112 | 					},
113 | 					Error: nil,
114 | 				},
115 | 			}},
116 | 		},
117 | 		{
118 | 			name: "two queries",
119 | 			plugin: &pluginMock{
120 | 				onExecQuery: func(_ context.Context, q *plugin.Query) (data.Frames, error) {
121 | 					return data.Frames{{
122 | 						Name: q.ValueID,
123 | 						Fields: []*data.Field{
124 | 							data.NewField("time", nil, []time.Time{time.Unix(1257894000, 0)}),
125 | 							data.NewField(q.ValueID, nil, []float64{3.141}).SetConfig(&data.FieldConfig{DisplayNameFromDS: q.AliasID}),
126 | 						}},
127 | 					}, nil
128 | 				},
129 | 			},
130 | 			request: &backend.QueryDataRequest{
131 | 				Queries: []backend.DataQuery{
132 | 					{
133 | 						RefID:     "123456789",
134 | 						TimeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(125789403, 0)},
135 | 						JSON: []byte(`{"datasourceId": 1, "queryType": "query", "rawQuery": true, "refId": "123456789",
136 | 							        "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
137 | 								    "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "1",
138 | 									"alias": "Alias1", "filtering": true}`),
139 | 					},
140 | 					{
141 | 						RefID:     "223456789",
142 | 						TimeRange: backend.TimeRange{From: time.Unix(1257894000, 0), To: time.Unix(125789403, 0)},
143 | 						JSON: []byte(`{"datasourceId": 1, "queryType": "query", "rawQuery": true, "refId": "223456789",
144 | 							        "target": "SELECT * from Keyspace.Table", "columnTime": "Time", "columnValue": "Value",
145 | 								    "keyspace": "Keyspace", "table": "Table", "columnId": "ID", "valueId": "2",
146 | 									"alias": "Alias2", "filtering": false}`),
147 | 					},
148 | 				},
149 | 			},
150 | 			want: &backend.QueryDataResponse{Responses: backend.Responses{
151 | 				"123456789": backend.DataResponse{
152 | 					Frames: data.Frames{{
153 | 						Name: "1",
154 | 						Fields: []*data.Field{
155 | 							data.NewField("time", nil, []time.Time{time.Unix(1257894000, 0)}),
156 | 							data.NewField("1", nil, []float64{3.141}).SetConfig(&data.FieldConfig{DisplayNameFromDS: "Alias1"}),
157 | 						}},
158 | 					},
159 | 					Error: nil,
160 | 				},
161 | 				"223456789": backend.DataResponse{
162 | 					Frames: data.Frames{{
163 | 						Name: "2",
164 | 						Fields: []*data.Field{
165 | 							data.NewField("time", nil, []time.Time{time.Unix(1257894000, 0)}),
166 | 							data.NewField("2", nil, []float64{3.141}).SetConfig(&data.FieldConfig{DisplayNameFromDS: "Alias2"}),
167 | 						}},
168 | 					},
169 | 					Error: nil,
170 | 				},
171 | 			}},
172 | 		},
173 | 	}
174 | 
175 | 	for _, tc := range testCases {
176 | 		t.Run(tc.name, func(t *testing.T) {
177 | 			h := &handler{instanceManager: &instanceManagerMock{plugin: tc.plugin}}
178 | 			result, err := h.queryMetricData(context.TODO(), tc.request)
179 | 			if err != nil {
180 | 				t.Fatalf("unexpected error: %v", err)
181 | 			}
182 | 
183 | 			assert.Equal(t, tc.want, result)
184 | 		})
185 | 	}
186 | }
187 | 
188 | func Test_CheckHealth(t *testing.T) {
189 | 	testCases := []struct {
190 | 		name   string
191 | 		plugin *pluginMock
192 | 		want   *backend.CheckHealthResult
193 | 	}{
194 | 		{
195 | 			name: "no error",
196 | 			plugin: &pluginMock{
197 | 				onCheckHealth: func(_ context.Context) error {
198 | 					return nil
199 | 				},
200 | 			},
201 | 			want: &backend.CheckHealthResult{
202 | 				Status:  backend.HealthStatusOk,
203 | 				Message: "Connected",
204 | 			},
205 | 		},
206 | 		{
207 | 			name: "error",
208 | 			plugin: &pluginMock{
209 | 				onCheckHealth: func(_ context.Context) error {
210 | 					return errors.New("some error")
211 | 				},
212 | 			},
213 | 			want: &backend.CheckHealthResult{
214 | 				Status:  backend.HealthStatusError,
215 | 				Message: "Error, check Grafana logs for more details",
216 | 			},
217 | 		},
218 | 	}
219 | 
220 | 	for _, tc := range testCases {
221 | 		t.Run(tc.name, func(t *testing.T) {
222 | 			h := handler{instanceManager: &instanceManagerMock{plugin: tc.plugin}}
223 | 			result, err := h.CheckHealth(context.TODO(), &backend.CheckHealthRequest{})
224 | 			if err != nil {
225 | 				t.Fatalf("unexpected error: %v", err)
226 | 			}
227 | 
228 | 			assert.Equal(t, result, tc.want)
229 | 		})
230 | 	}
231 | }
232 | 
233 | func Test_writeHTTPResult(t *testing.T) {
234 | 	testCases := []struct {
235 | 		name   string
236 | 		input  any
237 | 		status int
238 | 		want   string
239 | 	}{
240 | 		{
241 | 			name:   "nil",
242 | 			input:  nil,
243 | 			status: http.StatusOK,
244 | 			want:   "null",
245 | 		},
246 | 		{
247 | 			name:   "empty",
248 | 			input:  []string{},
249 | 			status: http.StatusOK,
250 | 			want:   "[]",
251 | 		},
252 | 		{
253 | 			name:   "one element",
254 | 			input:  []string{"ONE"},
255 | 			status: http.StatusOK,
256 | 			want: `[
257 |     "ONE"
258 | ]`,
259 | 		},
260 | 		{
261 | 			name:   "multiple elements",
262 | 			input:  []string{"ONE", "TWO", "THREE"},
263 | 			status: http.StatusOK,
264 | 			want: `[
265 |     "ONE",
266 |     "TWO",
267 |     "THREE"
268 | ]`,
269 | 		},
270 | 		{
271 | 			name: "variables",
272 | 			input: []plugin.Variable{
273 | 				{Value: "value1", Label: "text1"},
274 | 				{Value: "value2", Label: "text2"},
275 | 				{Value: "value3", Label: "text3"},
276 | 			},
277 | 			status: http.StatusOK,
278 | 			want: `[
279 |     {
280 |         "value": "value1",
281 |         "text": "text1"
282 |     },
283 |     {
284 |         "value": "value2",
285 |         "text": "text2"
286 |     },
287 |     {
288 |         "value": "value3",
289 |         "text": "text3"
290 |     }
291 | ]`,
292 | 		},
293 | 	}
294 | 
295 | 	for _, tc := range testCases {
296 | 		t.Run(tc.name, func(t *testing.T) {
297 | 			recorder := httptest.NewRecorder()
298 | 			writeHTTPResult(recorder, tc.input)
299 | 
300 | 			assert.Equal(t, recorder.Code, tc.status)
301 | 			assert.Equal(t, tc.want, recorder.Body.String())
302 | 		})
303 | 	}
304 | }
305 | 


--------------------------------------------------------------------------------
/backend/main.go:
--------------------------------------------------------------------------------
 1 | package main
 2 | 
 3 | import (
 4 | 	"context"
 5 | 	"crypto/tls"
 6 | 	"encoding/json"
 7 | 	"fmt"
 8 | 	"strings"
 9 | 
10 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/cassandra"
11 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/handler"
12 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/plugin"
13 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
14 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/datasource"
15 | 	"github.com/grafana/grafana-plugin-sdk-go/backend/instancemgmt"
16 | )
17 | 
18 | func newDataSource(ctx context.Context, settings backend.DataSourceInstanceSettings) (instancemgmt.Instance, error) {
19 | 	var dss dataSourceSettings
20 | 	err := json.Unmarshal(settings.JSONData, &dss)
21 | 	if err != nil {
22 | 		backend.Logger.Error("Failed to parse connection parameter", "Message", err)
23 | 		return nil, fmt.Errorf("Failed to parse connection parameters: %w", err)
24 | 	}
25 | 
26 | 	var tlsConfig *tls.Config
27 | 	if dss.UseCustomTLS {
28 | 		backend.Logger.Debug("Setting TLS Configuration...")
29 | 
30 | 		tlsConfig, err = prepareTLSCfg(dss.CertPath, dss.RootPath, dss.CaPath, dss.AllowInsecureTLS)
31 | 		if err != nil {
32 | 			backend.Logger.Error("Failed to create TLS config", "Message", err)
33 | 			return nil, fmt.Errorf("Failed to create TLS config: %w", err)
34 | 		}
35 | 	}
36 | 
37 | 	sessionSettings := cassandra.Settings{
38 | 		Hosts:       strings.Split(settings.URL, ";"),
39 | 		Keyspace:    dss.Keyspace,
40 | 		User:        dss.User,
41 | 		Password:    settings.DecryptedSecureJSONData["password"],
42 | 		Consistency: dss.Consistency,
43 | 		Timeout:     dss.Timeout,
44 | 		TLSConfig:   tlsConfig,
45 | 	}
46 | 
47 | 	session, err := cassandra.New(sessionSettings)
48 | 	if err != nil {
49 | 		backend.Logger.Error("Failed to create Cassandra connection", "Message", err)
50 | 		return nil, fmt.Errorf("Failed to create Cassandra connection, check Grafana logs for more details")
51 | 	}
52 | 
53 | 	return plugin.New(session), nil
54 | }
55 | 
56 | func main() {
57 | 	backend.Logger.Debug("Running Cassandra backend datasource...")
58 | 
59 | 	err := datasource.Serve(handler.New(newDataSource))
60 | 	if err != nil {
61 | 		backend.Logger.Error("Error serving cassandra requests: ", err.Error())
62 | 	}
63 | }
64 | 


--------------------------------------------------------------------------------
/backend/plugin/plugin.go:
--------------------------------------------------------------------------------
  1 | package plugin
  2 | 
  3 | import (
  4 | 	"context"
  5 | 	"fmt"
  6 | 	"regexp"
  7 | 	"strings"
  8 | 	"time"
  9 | 
 10 | 	"github.com/HadesArchitect/GrafanaCassandraDatasource/backend/cassandra"
 11 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
 12 | 	"github.com/grafana/grafana-plugin-sdk-go/data"
 13 | )
 14 | 
 15 | var aliasFormatRegexp = regexp.MustCompile(`\{\{\s*(.+?)\s*\}\}`)
 16 | 
 17 | type repository interface {
 18 | 	Select(ctx context.Context, query string, values ...interface{}) (rows map[string][]cassandra.Row, err error)
 19 | 	GetKeyspaces(ctx context.Context) ([]string, error)
 20 | 	GetTables(keyspace string) ([]string, error)
 21 | 	GetColumns(keyspace, table, needType string) ([]string, error)
 22 | 	Ping(ctx context.Context) error
 23 | 	Close()
 24 | }
 25 | 
 26 | // Plugin represents grafana datasource plugin.
 27 | type Plugin struct {
 28 | 	repo repository
 29 | }
 30 | 
 31 | // New returns configured Plugin.
 32 | func New(repo repository) *Plugin {
 33 | 	return &Plugin{
 34 | 		repo: repo,
 35 | 	}
 36 | }
 37 | 
 38 | // ExecQuery executes metric query based on provided query type.
 39 | func (p *Plugin) ExecQuery(ctx context.Context, q *Query) (data.Frames, error) {
 40 | 	var (
 41 | 		dataFrames data.Frames
 42 | 		err        error
 43 | 	)
 44 | 
 45 | 	backend.Logger.Debug("ExecQuery", "query", q)
 46 | 	switch q.RawQuery {
 47 | 	case true:
 48 | 		dataFrames, err = p.execRawMetricQuery(ctx, q)
 49 | 	case false:
 50 | 		dataFrames, err = p.execStrictMetricQuery(ctx, q)
 51 | 	}
 52 | 
 53 | 	if err != nil {
 54 | 		return nil, fmt.Errorf("query processing: %w", err)
 55 | 	}
 56 | 
 57 | 	return dataFrames, nil
 58 | }
 59 | 
 60 | // execRawMetricQuery executes repository ExecRawQuery method and transforms reposonse to data.Frames.
 61 | func (p *Plugin) execRawMetricQuery(ctx context.Context, q *Query) (data.Frames, error) {
 62 | 	rows, err := p.repo.Select(ctx, q.Target)
 63 | 	if err != nil {
 64 | 		return nil, fmt.Errorf("repo.Select: %w", err)
 65 | 	}
 66 | 
 67 | 	return makeDataFrames(q, rows), nil
 68 | }
 69 | 
 70 | // execStrictMetricQuery executes repository ExecStrictQuery method and transforms reposonse to data.Frames.
 71 | func (p *Plugin) execStrictMetricQuery(ctx context.Context, q *Query) (data.Frames, error) {
 72 | 	rows, err := p.repo.Select(ctx, q.BuildStatement(), splitIDs(q.ValueID), q.TimeFrom, q.TimeTo)
 73 | 	if err != nil {
 74 | 		return nil, fmt.Errorf("repo.ExecStrictQuery: %w", err)
 75 | 	}
 76 | 
 77 | 	return makeDataFrames(q, rows), nil
 78 | }
 79 | 
 80 | // GetKeyspaces fetches and returns Cassandra's list of keyspaces.
 81 | func (p *Plugin) GetKeyspaces(ctx context.Context) ([]string, error) {
 82 | 	keyspaces, err := p.repo.GetKeyspaces(ctx)
 83 | 	if err != nil {
 84 | 		return nil, fmt.Errorf("repo.GetKeyspaces: %w", err)
 85 | 	}
 86 | 
 87 | 	return keyspaces, nil
 88 | }
 89 | 
 90 | // GetTables fetches and returns Cassandra's list of tables for provided keyspace.
 91 | func (p *Plugin) GetTables(keyspace string) ([]string, error) {
 92 | 	tables, err := p.repo.GetTables(keyspace)
 93 | 	if err != nil {
 94 | 		return nil, fmt.Errorf("repo.GetTables: %w", err)
 95 | 	}
 96 | 
 97 | 	return tables, nil
 98 | }
 99 | 
100 | // GetColumns fetches and returns Cassandra's list of columns
101 | // of given type for provided keyspace and table.
102 | func (p *Plugin) GetColumns(keyspace, table, needType string) ([]string, error) {
103 | 	columns, err := p.repo.GetColumns(keyspace, table, needType)
104 | 	if err != nil {
105 | 		return nil, fmt.Errorf("repo.GetColumns: %w", err)
106 | 	}
107 | 
108 | 	return columns, nil
109 | }
110 | 
111 | // GetVariables fetches and returns data to create variables.
112 | func (p *Plugin) GetVariables(ctx context.Context, query string) ([]Variable, error) {
113 | 	backend.Logger.Debug("GetVariables", "query", query)
114 | 
115 | 	idRows, err := p.repo.Select(ctx, query)
116 | 	if err != nil {
117 | 		return nil, fmt.Errorf("repo.Select: %w", err)
118 | 	}
119 | 
120 | 	vars := make([]Variable, 0, len(idRows))
121 | 	for _, rows := range idRows {
122 | 		for _, row := range rows {
123 | 			vars = append(vars, makeVariableFromRow(row))
124 | 		}
125 | 	}
126 | 
127 | 	return vars, nil
128 | }
129 | 
130 | // CheckHealth executes repository Ping method to check database health.
131 | func (p *Plugin) CheckHealth(ctx context.Context) error {
132 | 	err := p.repo.Ping(ctx)
133 | 	if err != nil {
134 | 		return fmt.Errorf("repo.Ping: %w", err)
135 | 	}
136 | 
137 | 	return nil
138 | }
139 | 
140 | // Dispose closes all connections to Cassandra cluster.
141 | func (p *Plugin) Dispose() {
142 | 	p.repo.Close()
143 | }
144 | 
145 | func splitIDs(s string) []string {
146 | 	var ids []string
147 | 	for _, id := range strings.Split(s, ",") {
148 | 		ids = append(ids, strings.TrimSpace(id))
149 | 	}
150 | 
151 | 	return ids
152 | }
153 | 
154 | func makeDataFrames(q *Query, rows map[string][]cassandra.Row) data.Frames {
155 | 	var frames data.Frames
156 | 	for id, points := range rows {
157 | 		frame := makeDataFrameFromRows(id, q.AliasID, points)
158 | 		if q.IsAlertQuery {
159 | 			// alerting doesn't support narrow frames
160 | 			frame = narrowFrameToWideFrame(frame)
161 | 		}
162 | 		frames = append(frames, frame)
163 | 	}
164 | 
165 | 	return frames
166 | }
167 | 
168 | // makeDataFrameFromRows creates data frames from time series points returned by repository.
169 | func makeDataFrameFromRows(id string, alias string, rows []cassandra.Row) *data.Frame {
170 | 	if len(rows) == 0 {
171 | 		return nil
172 | 	}
173 | 
174 | 	frame := data.NewFrame(id, nil)
175 | 
176 | 	// use first of the returned rows to interpolate legend alias.
177 | 	alias = formatAlias(alias, rows[0].Fields)
178 | 	fields := make([]*data.Field, 0, len(rows[0].Columns))
179 | 	for _, colName := range rows[0].Columns {
180 | 		field := data.NewFieldFromFieldType(data.FieldTypeFor(rows[0].Fields[colName]), 0)
181 | 		field.Name = colName
182 | 		if alias != "" && field.Type().Numeric() {
183 | 			field.SetConfig(&data.FieldConfig{DisplayNameFromDS: alias})
184 | 		}
185 | 		fields = append(fields, field)
186 | 	}
187 | 	frame.Fields = fields
188 | 
189 | 	for _, r := range rows {
190 | 		values := make([]interface{}, 0, len(r.Fields))
191 | 		for _, colName := range r.Columns {
192 | 			values = append(values, r.Fields[colName])
193 | 		}
194 | 		frame.AppendRow(values...)
195 | 	}
196 | 
197 | 	return frame
198 | }
199 | 
200 | // formatAlias performs legend alies interpolation.
201 | func formatAlias(alias string, values map[string]interface{}) string {
202 | 	formattedAlias := aliasFormatRegexp.ReplaceAllFunc([]byte(alias), func(in []byte) []byte {
203 | 		fieldName := strings.Replace(string(in), "{{", "", 1)
204 | 		fieldName = strings.Replace(fieldName, "}}", "", 1)
205 | 		fieldName = strings.TrimSpace(fieldName)
206 | 		if val, exists := values[fieldName]; exists {
207 | 			switch v := val.(type) {
208 | 			case string:
209 | 				return []byte(v)
210 | 			case int8, int32, int64, int:
211 | 				return []byte(fmt.Sprintf("%d", v))
212 | 			case float32, float64:
213 | 				return []byte(fmt.Sprintf("%f", v))
214 | 			case bool:
215 | 				return []byte(fmt.Sprintf("%t", v))
216 | 			case time.Time:
217 | 				return []byte(v.String())
218 | 			default:
219 | 				return []byte{}
220 | 			}
221 | 		}
222 | 		return []byte{}
223 | 	})
224 | 
225 | 	return string(formattedAlias)
226 | }
227 | 
228 | // narrowFrameToWideFrame performs rudimentary frames conversion from narrow to wide format.
229 | // It puts non-TS fields to labels and removes from fields list. Conflicting labels are replaced.
230 | // Any other field is ignored and could cause grafana alerting error during alert query execution.
231 | // https://grafana.com/developers/plugin-tools/introduction/data-frames#data-frames-as-time-series
232 | func narrowFrameToWideFrame(frame *data.Frame) *data.Frame {
233 | 	if len(frame.Fields) == 0 {
234 | 		return frame
235 | 	}
236 | 
237 | 	labels := makeLabelsFromNonTSFields(frame)
238 | 	for i := 0; i < len(frame.Fields); i++ {
239 | 		if frame.Fields[i].Type().Numeric() {
240 | 			if frame.Fields[i].Labels == nil {
241 | 				frame.Fields[i].Labels = make(map[string]string, len(labels))
242 | 			}
243 | 			for k, v := range labels {
244 | 				frame.Fields[i].Labels[k] = v
245 | 			}
246 | 		}
247 | 	}
248 | 
249 | 	return removeNonTSFields(frame)
250 | }
251 | 
252 | // makeLabelsFromNonTSFields creates map of labels and their corresponding
253 | // values from all fields that are not numeric or timestamps. Only first
254 | // value from each field used as label value.
255 | func makeLabelsFromNonTSFields(frame *data.Frame) map[string]string {
256 | 	labels := make(map[string]string)
257 | 	if frame == nil || len(frame.Fields) == 0 || frame.Fields[0].Len() == 0 {
258 | 		return labels
259 | 	}
260 | 
261 | 	for _, f := range frame.Fields {
262 | 		if !f.Type().Numeric() && !f.Type().Time() {
263 | 			labels[f.Name] = fmt.Sprintf("%v", f.CopyAt(0))
264 | 		}
265 | 	}
266 | 
267 | 	return labels
268 | }
269 | 
270 | // removeNonTSFields deletes all fields that are not numeric or timestamps
271 | // from frame. These values should be previously stored to labels
272 | // using makeLabelsFromNonTSFields method. Result is not stable, e.g.
273 | // elements can change their positions during filtration.
274 | func removeNonTSFields(frame *data.Frame) *data.Frame {
275 | 	if frame == nil {
276 | 		return nil
277 | 	}
278 | 
279 | 	i, j := 0, len(frame.Fields)-1
280 | 	for i <= j {
281 | 		// keep numeric and timestamp fields
282 | 		if frame.Fields[i].Type().Numeric() || frame.Fields[i].Type().Time() {
283 | 			i++
284 | 			continue
285 | 		}
286 | 		// move all the other fields to the end of the Fields slice
287 | 		frame.Fields[i], frame.Fields[j] = frame.Fields[j], frame.Fields[i]
288 | 		j--
289 | 	}
290 | 
291 | 	frame.Fields = frame.Fields[0:i]
292 | 
293 | 	return frame
294 | }
295 | 
296 | // Variable is a type to transfer variable data from backend to frontend,
297 | // where it will be put into MetricFindValue type.
298 | // https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/datasource.ts#L595
299 | type Variable struct {
300 | 	Value string `json:"value"`
301 | 	Label string `json:"text"`
302 | }
303 | 
304 | func makeVariableFromRow(row cassandra.Row) Variable {
305 | 	var v Variable
306 | 	v.Value = fmt.Sprintf("%v", row.Fields[row.Columns[0]])
307 | 	v.Label = v.Value
308 | 	if len(row.Columns) > 1 {
309 | 		v.Label = fmt.Sprintf("%v", row.Fields[row.Columns[1]])
310 | 	}
311 | 
312 | 	return v
313 | }
314 | 


--------------------------------------------------------------------------------
/backend/plugin/query.go:
--------------------------------------------------------------------------------
 1 | package plugin
 2 | 
 3 | import (
 4 | 	"fmt"
 5 | 	"time"
 6 | 
 7 | 	"github.com/grafana/grafana-plugin-sdk-go/backend"
 8 | )
 9 | 
10 | type Query struct {
11 | 	RawQuery       bool
12 | 	Target         string
13 | 	Keyspace       string
14 | 	Table          string
15 | 	ColumnValue    string
16 | 	ColumnID       string
17 | 	ValueID        string
18 | 	AliasID        string
19 | 	ColumnTime     string
20 | 	TimeFrom       time.Time
21 | 	TimeTo         time.Time
22 | 	AllowFiltering bool
23 | 	Instant        bool
24 | 	IsAlertQuery   bool
25 | }
26 | 
27 | // BuildStatement builds cassandra query statement with positional parameters.
28 | func (q *Query) BuildStatement() string {
29 | 	var allowFiltering string
30 | 	if q.AllowFiltering {
31 | 		allowFiltering = " ALLOW FILTERING"
32 | 	}
33 | 
34 | 	var perPartitionLimit string
35 | 	if q.Instant {
36 | 		perPartitionLimit = " PER PARTITION LIMIT 1"
37 | 	}
38 | 
39 | 	statement := fmt.Sprintf(
40 | 		"SELECT %s, %s, %s FROM %s.%s WHERE %s IN ? AND %s >= ? AND %s <= ?%s%s",
41 | 		q.ColumnID,
42 | 		q.ColumnValue,
43 | 		q.ColumnTime,
44 | 		q.Keyspace,
45 | 		q.Table,
46 | 		q.ColumnID,
47 | 		q.ColumnTime,
48 | 		q.ColumnTime,
49 | 		perPartitionLimit,
50 | 		allowFiltering,
51 | 	)
52 | 
53 | 	backend.Logger.Debug("Built strict statement", "statement", statement)
54 | 
55 | 	return statement
56 | }
57 | 


--------------------------------------------------------------------------------
/backend/plugin/query_test.go:
--------------------------------------------------------------------------------
 1 | package plugin
 2 | 
 3 | import (
 4 | 	"testing"
 5 | 
 6 | 	"github.com/stretchr/testify/assert"
 7 | )
 8 | 
 9 | func TestQuery_BuildStatement(t *testing.T) {
10 | 	testCases := []struct {
11 | 		name  string
12 | 		input *Query
13 | 		want  string
14 | 	}{
15 | 		{
16 | 			name: "without AllowFiltering and Instant",
17 | 			input: &Query{
18 | 				Keyspace:       "Keyspace",
19 | 				Table:          "Table",
20 | 				ColumnValue:    "Value",
21 | 				ColumnID:       "ID",
22 | 				ColumnTime:     "Time",
23 | 				AllowFiltering: false,
24 | 				Instant:        false,
25 | 			},
26 | 			want: "SELECT ID, Value, Time FROM Keyspace.Table WHERE ID IN ? AND Time >= ? AND Time <= ?",
27 | 		},
28 | 		{
29 | 			name: "with AllowFiltering",
30 | 			input: &Query{
31 | 				Keyspace:       "Keyspace",
32 | 				Table:          "Table",
33 | 				ColumnValue:    "Value",
34 | 				ColumnID:       "ID",
35 | 				ColumnTime:     "Time",
36 | 				AllowFiltering: true,
37 | 				Instant:        false,
38 | 			},
39 | 			want: "SELECT ID, Value, Time FROM Keyspace.Table WHERE ID IN ? AND Time >= ? AND Time <= ? ALLOW FILTERING",
40 | 		},
41 | 		{
42 | 			name: "with Instant",
43 | 			input: &Query{
44 | 				Keyspace:       "Keyspace",
45 | 				Table:          "Table",
46 | 				ColumnValue:    "Value",
47 | 				ColumnID:       "ID",
48 | 				ColumnTime:     "Time",
49 | 				AllowFiltering: false,
50 | 				Instant:        true,
51 | 			},
52 | 			want: "SELECT ID, Value, Time FROM Keyspace.Table WHERE ID IN ? AND Time >= ? AND Time <= ? PER PARTITION LIMIT 1",
53 | 		},
54 | 		{
55 | 			name: "with AllowFiltering and Instant",
56 | 			input: &Query{
57 | 				Keyspace:       "Keyspace",
58 | 				Table:          "Table",
59 | 				ColumnValue:    "Value",
60 | 				ColumnID:       "ID",
61 | 				ColumnTime:     "Time",
62 | 				AllowFiltering: true,
63 | 				Instant:        true,
64 | 			},
65 | 			want: "SELECT ID, Value, Time FROM Keyspace.Table WHERE ID IN ? AND Time >= ? AND Time <= ? PER PARTITION LIMIT 1 ALLOW FILTERING",
66 | 		},
67 | 	}
68 | 
69 | 	for _, tc := range testCases {
70 | 		t.Run(tc.name, func(t *testing.T) {
71 | 			queryString := tc.input.BuildStatement()
72 | 			assert.Equal(t, tc.want, queryString, tc.name)
73 | 		})
74 | 	}
75 | }
76 | 


--------------------------------------------------------------------------------
/backend/settings.go:
--------------------------------------------------------------------------------
 1 | package main
 2 | 
 3 | import (
 4 | 	"crypto/tls"
 5 | 	"crypto/x509"
 6 | 	"fmt"
 7 | 	"io/ioutil"
 8 | 	"path/filepath"
 9 | )
10 | 
11 | // dataSourceSettings is a convenient presentation of a
12 | // backend.DataSourceInstanceSettings JSON data.
13 | type dataSourceSettings struct {
14 | 	Keyspace         string `json:"keyspace"`
15 | 	User             string `json:"user"`
16 | 	Password         string `json:"password"`
17 | 	Consistency      string `json:"consistency"`
18 | 	CertPath         string `json:"certPath"`
19 | 	RootPath         string `json:"rootPath"`
20 | 	CaPath           string `json:"caPath"`
21 | 	Timeout          *int   `json:"timeout"`
22 | 	UseCustomTLS     bool   `json:"UseCustomTLS"`
23 | 	AllowInsecureTLS bool   `json:"allowInsecureTLS"`
24 | }
25 | 
26 | // prepareTLSCfg is a helper to create a tls.Config using provided file paths.
27 | func prepareTLSCfg(certPath string, rootPath string, caPath string, allowInsecureTLS bool) (*tls.Config, error) {
28 | 	tlsConfig := &tls.Config{InsecureSkipVerify: allowInsecureTLS}
29 | 	if certPath != "" && rootPath != "" {
30 | 		cert, err := filepath.Abs(certPath)
31 | 		if err != nil {
32 | 			return nil, err
33 | 		}
34 | 		key, err := filepath.Abs(rootPath)
35 | 		if err != nil {
36 | 			return nil, err
37 | 		}
38 | 		certificate, err := tls.LoadX509KeyPair(cert, key)
39 | 		if err != nil {
40 | 			return nil, err
41 | 		}
42 | 		tlsConfig.Certificates = append(tlsConfig.Certificates, certificate)
43 | 	}
44 | 
45 | 	if caPath != "" {
46 | 		caCertPEMPath, err := filepath.Abs(caPath)
47 | 		if err != nil {
48 | 			return nil, err
49 | 		}
50 | 		caCertPEM, err := ioutil.ReadFile(caCertPEMPath)
51 | 		if err != nil {
52 | 			return nil, err
53 | 		}
54 | 		roots := x509.NewCertPool()
55 | 		if ok := roots.AppendCertsFromPEM(caCertPEM); !ok {
56 | 			return nil, fmt.Errorf("failed to parse root certificate")
57 | 		}
58 | 		tlsConfig.RootCAs = roots
59 | 	}
60 | 
61 | 	return tlsConfig, nil
62 | }


--------------------------------------------------------------------------------
/contributors.md:
--------------------------------------------------------------------------------
 1 | # Maintainers
 2 | 
 3 | * Aleks Volochnev
 4 |     * [a.volochnev@gmail.com](mailto:a.volochnev@gmail.com)
 5 |     * [linkedin.com/in/aleks-volochnev](https://www.linkedin.com/in/aleks-volochnev/)
 6 | * Armen Khachkinaev
 7 |     * [armen114@yandex.ru](mailto:armen114@yandex.ru)
 8 |     * [linkedin.com/in/armen-khachkinaev](https://www.linkedin.com/in/armen-khachkinaev/)
 9 | * Vyacheslav Mitrofanov
10 |     * [linkedin.com/in/unflag/](https://www.linkedin.com/in/unflag/)
11 | 


--------------------------------------------------------------------------------
/demo/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM grafana/grafana:10.4.19
2 | RUN grafana-cli plugins install hadesarchitect-cassandra-datasource
3 | 


--------------------------------------------------------------------------------
/demo/dashboard.json:
--------------------------------------------------------------------------------
  1 | {
  2 |   "__inputs": [
  3 |     {
  4 |       "name": "DS_APACHE_CASSANDRA",
  5 |       "label": "Apache Cassandra",
  6 |       "description": "",
  7 |       "type": "datasource",
  8 |       "pluginId": "hadesarchitect-cassandra-datasource",
  9 |       "pluginName": "Apache Cassandra"
 10 |     }
 11 |   ],
 12 |   "__elements": {},
 13 |   "__requires": [
 14 |     {
 15 |       "type": "grafana",
 16 |       "id": "grafana",
 17 |       "name": "Grafana",
 18 |       "version": "10.1.1"
 19 |     },
 20 |     {
 21 |       "type": "panel",
 22 |       "id": "graph",
 23 |       "name": "Graph (old)",
 24 |       "version": ""
 25 |     },
 26 |     {
 27 |       "type": "datasource",
 28 |       "id": "hadesarchitect-cassandra-datasource",
 29 |       "name": "Apache Cassandra",
 30 |       "version": "2.3.0"
 31 |     },
 32 |     {
 33 |       "type": "panel",
 34 |       "id": "table",
 35 |       "name": "Table",
 36 |       "version": ""
 37 |     },
 38 |     {
 39 |       "type": "panel",
 40 |       "id": "timeseries",
 41 |       "name": "Time series",
 42 |       "version": ""
 43 |     }
 44 |   ],
 45 |   "annotations": {
 46 |     "list": [
 47 |       {
 48 |         "builtIn": 1,
 49 |         "datasource": {
 50 |           "type": "datasource",
 51 |           "uid": "grafana"
 52 |         },
 53 |         "enable": true,
 54 |         "hide": true,
 55 |         "iconColor": "rgba(0, 211, 255, 1)",
 56 |         "name": "Annotations & Alerts",
 57 |         "type": "dashboard"
 58 |       }
 59 |     ]
 60 |   },
 61 |   "editable": true,
 62 |   "fiscalYearStartMonth": 0,
 63 |   "graphTooltip": 0,
 64 |   "id": null,
 65 |   "links": [],
 66 |   "liveNow": false,
 67 |   "panels": [
 68 |     {
 69 |       "datasource": {
 70 |         "type": "hadesarchitect-cassandra-datasource",
 71 |         "uid": "${DS_APACHE_CASSANDRA}"
 72 |       },
 73 |       "description": "This panel demonstrates the powerful Query Editor of Apache Cassandra Datasource for Grafana",
 74 |       "fieldConfig": {
 75 |         "defaults": {
 76 |           "color": {
 77 |             "mode": "palette-classic"
 78 |           },
 79 |           "custom": {
 80 |             "axisCenteredZero": false,
 81 |             "axisColorMode": "text",
 82 |             "axisLabel": "",
 83 |             "axisPlacement": "auto",
 84 |             "barAlignment": 0,
 85 |             "drawStyle": "line",
 86 |             "fillOpacity": 0,
 87 |             "gradientMode": "none",
 88 |             "hideFrom": {
 89 |               "legend": false,
 90 |               "tooltip": false,
 91 |               "viz": false
 92 |             },
 93 |             "insertNulls": false,
 94 |             "lineInterpolation": "linear",
 95 |             "lineWidth": 1,
 96 |             "pointSize": 5,
 97 |             "scaleDistribution": {
 98 |               "type": "linear"
 99 |             },
100 |             "showPoints": "auto",
101 |             "spanNulls": false,
102 |             "stacking": {
103 |               "group": "A",
104 |               "mode": "none"
105 |             },
106 |             "thresholdsStyle": {
107 |               "mode": "off"
108 |             }
109 |           },
110 |           "mappings": [],
111 |           "thresholds": {
112 |             "mode": "absolute",
113 |             "steps": [
114 |               {
115 |                 "color": "green",
116 |                 "value": null
117 |               },
118 |               {
119 |                 "color": "red",
120 |                 "value": 80
121 |               }
122 |             ]
123 |           }
124 |         },
125 |         "overrides": []
126 |       },
127 |       "gridPos": {
128 |         "h": 8,
129 |         "w": 8,
130 |         "x": 0,
131 |         "y": 0
132 |       },
133 |       "id": 4,
134 |       "options": {
135 |         "legend": {
136 |           "calcs": [],
137 |           "displayMode": "list",
138 |           "placement": "bottom",
139 |           "showLegend": true
140 |         },
141 |         "tooltip": {
142 |           "mode": "single",
143 |           "sort": "none"
144 |         }
145 |       },
146 |       "pluginVersion": "10.1.1",
147 |       "targets": [
148 |         {
149 |           "alias": "{{ sensor_id }}:{{ location }}",
150 |           "columnId": " ",
151 |           "columnTime": " ",
152 |           "columnValue": " ",
153 |           "datasource": {
154 |             "type": "hadesarchitect-cassandra-datasource",
155 |             "uid": "${DS_APACHE_CASSANDRA}"
156 |           },
157 |           "datasourceId": 1,
158 |           "queryType": "query",
159 |           "rawQuery": true,
160 |           "refId": "A",
161 |           "target": "SELECT sensor_id, temperature, registered_at, location FROM test.test WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd1, 99051fe9-6a9c-46c2-b949-38ef78858dd0) AND registered_at > $__timeFrom and registered_at < $__timeTo",
162 |           "type": "timeserie"
163 |         }
164 |       ],
165 |       "title": "Query Editor Demo",
166 |       "transformations": [],
167 |       "type": "timeseries"
168 |     },
169 |     {
170 |       "aliasColors": {},
171 |       "bars": false,
172 |       "dashLength": 10,
173 |       "dashes": false,
174 |       "datasource": {
175 |         "type": "hadesarchitect-cassandra-datasource",
176 |         "uid": "${DS_APACHE_CASSANDRA}"
177 |       },
178 |       "description": "This panel is configured using Apache Cassandra Datasource and Query Configurator",
179 |       "fill": 1,
180 |       "fillGradient": 0,
181 |       "gridPos": {
182 |         "h": 8,
183 |         "w": 8,
184 |         "x": 8,
185 |         "y": 0
186 |       },
187 |       "hiddenSeries": false,
188 |       "id": 2,
189 |       "legend": {
190 |         "avg": false,
191 |         "current": false,
192 |         "max": false,
193 |         "min": false,
194 |         "show": true,
195 |         "total": false,
196 |         "values": false
197 |       },
198 |       "lines": true,
199 |       "linewidth": 1,
200 |       "nullPointMode": "null",
201 |       "options": {
202 |         "alertThreshold": true
203 |       },
204 |       "percentage": false,
205 |       "pluginVersion": "10.1.1",
206 |       "pointradius": 2,
207 |       "points": false,
208 |       "renderer": "flot",
209 |       "seriesOverrides": [],
210 |       "spaceLength": 10,
211 |       "stack": false,
212 |       "steppedLine": false,
213 |       "targets": [
214 |         {
215 |           "alias": "ID:{{ sensor_id }}",
216 |           "columnId": "sensor_id",
217 |           "columnTime": "registered_at",
218 |           "columnValue": "temperature",
219 |           "datasource": {
220 |             "type": "hadesarchitect-cassandra-datasource",
221 |             "uid": "${DS_APACHE_CASSANDRA}"
222 |           },
223 |           "datasourceId": 1,
224 |           "instant": false,
225 |           "keyspace": "test",
226 |           "queryType": "query",
227 |           "refId": "A",
228 |           "table": "test",
229 |           "target": "select timestamp, value from keyspace.table where id=123e4567;",
230 |           "type": "timeserie",
231 |           "valueId": "99051fe9-6a9c-46c2-b949-38ef78858dd0, 99051fe9-6a9c-46c2-b949-38ef78858dd1"
232 |         }
233 |       ],
234 |       "thresholds": [],
235 |       "timeRegions": [],
236 |       "title": "Query Configurator Demo",
237 |       "tooltip": {
238 |         "shared": true,
239 |         "sort": 0,
240 |         "value_type": "individual"
241 |       },
242 |       "type": "graph",
243 |       "xaxis": {
244 |         "mode": "time",
245 |         "show": true,
246 |         "values": []
247 |       },
248 |       "yaxes": [
249 |         {
250 |           "format": "short",
251 |           "logBase": 1,
252 |           "show": true
253 |         },
254 |         {
255 |           "format": "short",
256 |           "logBase": 1,
257 |           "show": true
258 |         }
259 |       ],
260 |       "yaxis": {
261 |         "align": false
262 |       }
263 |     },
264 |     {
265 |       "datasource": {
266 |         "type": "hadesarchitect-cassandra-datasource",
267 |         "uid": "${DS_APACHE_CASSANDRA}"
268 |       },
269 |       "description": "This panel demonstrates the powerful Query Editor of Apache Cassandra Datasource for Grafana",
270 |       "fieldConfig": {
271 |         "defaults": {
272 |           "color": {
273 |             "mode": "palette-classic"
274 |           },
275 |           "custom": {
276 |             "axisCenteredZero": false,
277 |             "axisColorMode": "text",
278 |             "axisLabel": "",
279 |             "axisPlacement": "auto",
280 |             "barAlignment": 0,
281 |             "drawStyle": "line",
282 |             "fillOpacity": 0,
283 |             "gradientMode": "none",
284 |             "hideFrom": {
285 |               "legend": false,
286 |               "tooltip": false,
287 |               "viz": false
288 |             },
289 |             "insertNulls": false,
290 |             "lineInterpolation": "linear",
291 |             "lineWidth": 1,
292 |             "pointSize": 5,
293 |             "scaleDistribution": {
294 |               "type": "linear"
295 |             },
296 |             "showPoints": "auto",
297 |             "spanNulls": false,
298 |             "stacking": {
299 |               "group": "A",
300 |               "mode": "none"
301 |             },
302 |             "thresholdsStyle": {
303 |               "mode": "off"
304 |             }
305 |           },
306 |           "mappings": [],
307 |           "thresholds": {
308 |             "mode": "absolute",
309 |             "steps": [
310 |               {
311 |                 "color": "green",
312 |                 "value": null
313 |               },
314 |               {
315 |                 "color": "red",
316 |                 "value": 80
317 |               }
318 |             ]
319 |           }
320 |         },
321 |         "overrides": []
322 |       },
323 |       "gridPos": {
324 |         "h": 8,
325 |         "w": 8,
326 |         "x": 16,
327 |         "y": 0
328 |       },
329 |       "id": 7,
330 |       "options": {
331 |         "legend": {
332 |           "calcs": [],
333 |           "displayMode": "list",
334 |           "placement": "bottom",
335 |           "showLegend": true
336 |         },
337 |         "tooltip": {
338 |           "mode": "single",
339 |           "sort": "none"
340 |         }
341 |       },
342 |       "pluginVersion": "10.1.1",
343 |       "targets": [
344 |         {
345 |           "alias": "{{ sensor_id }}:{{ location }}",
346 |           "columnId": " ",
347 |           "columnTime": " ",
348 |           "columnValue": " ",
349 |           "datasource": {
350 |             "type": "hadesarchitect-cassandra-datasource",
351 |             "uid": "${DS_APACHE_CASSANDRA}"
352 |           },
353 |           "datasourceId": 1,
354 |           "queryType": "query",
355 |           "rawQuery": true,
356 |           "refId": "A",
357 |           "target": "SELECT sensor_id, temperature, registered_at, location FROM test.test WHERE sensor_id = ${loc} AND registered_at > $__timeFrom and registered_at < $__timeTo",
358 |           "type": "timeserie"
359 |         }
360 |       ],
361 |       "title": "Query By Variable Demo",
362 |       "transformations": [],
363 |       "type": "timeseries"
364 |     },
365 |     {
366 |       "datasource": {
367 |         "type": "hadesarchitect-cassandra-datasource",
368 |         "uid": "${DS_APACHE_CASSANDRA}"
369 |       },
370 |       "description": "This panel demonstrates the table mode of Apache Cassandra Datasource for Grafana",
371 |       "fieldConfig": {
372 |         "defaults": {
373 |           "color": {
374 |             "mode": "thresholds"
375 |           },
376 |           "custom": {
377 |             "align": "auto",
378 |             "cellOptions": {
379 |               "type": "auto"
380 |             },
381 |             "filterable": false,
382 |             "inspect": false
383 |           },
384 |           "mappings": [],
385 |           "thresholds": {
386 |             "mode": "absolute",
387 |             "steps": [
388 |               {
389 |                 "color": "green",
390 |                 "value": null
391 |               },
392 |               {
393 |                 "color": "red",
394 |                 "value": 80
395 |               }
396 |             ]
397 |           }
398 |         },
399 |         "overrides": [
400 |           {
401 |             "matcher": {
402 |               "id": "byName",
403 |               "options": "Temperature"
404 |             },
405 |             "properties": [
406 |               {
407 |                 "id": "custom.width",
408 |                 "value": 104
409 |               }
410 |             ]
411 |           },
412 |           {
413 |             "matcher": {
414 |               "id": "byName",
415 |               "options": "Sensor ID"
416 |             },
417 |             "properties": [
418 |               {
419 |                 "id": "custom.width",
420 |                 "value": 374
421 |               }
422 |             ]
423 |           }
424 |         ]
425 |       },
426 |       "gridPos": {
427 |         "h": 7,
428 |         "w": 12,
429 |         "x": 0,
430 |         "y": 8
431 |       },
432 |       "id": 5,
433 |       "options": {
434 |         "cellHeight": "sm",
435 |         "footer": {
436 |           "countRows": false,
437 |           "fields": [
438 |             "temperature"
439 |           ],
440 |           "reducer": [
441 |             "range"
442 |           ],
443 |           "show": true
444 |         },
445 |         "frameIndex": 0,
446 |         "showHeader": true,
447 |         "sortBy": []
448 |       },
449 |       "pluginVersion": "10.1.1",
450 |       "targets": [
451 |         {
452 |           "alias": "",
453 |           "columnId": " ",
454 |           "columnTime": " ",
455 |           "columnValue": " ",
456 |           "datasource": {
457 |             "type": "hadesarchitect-cassandra-datasource",
458 |             "uid": "${DS_APACHE_CASSANDRA}"
459 |           },
460 |           "datasourceId": 1,
461 |           "queryType": "query",
462 |           "rawQuery": true,
463 |           "refId": "A",
464 |           "target": "SELECT sensor_id, temperature, registered_at, location FROM test.test WHERE sensor_id IN (99051fe9-6a9c-46c2-b949-38ef78858dd1, 99051fe9-6a9c-46c2-b949-38ef78858dd0) AND registered_at > $__timeFrom and registered_at < $__timeTo PER PARTITION LIMIT 1",
465 |           "type": "timeserie"
466 |         }
467 |       ],
468 |       "title": "Table Editor Demo",
469 |       "transformations": [
470 |         {
471 |           "id": "merge",
472 |           "options": {}
473 |         },
474 |         {
475 |           "id": "organize",
476 |           "options": {
477 |             "excludeByName": {
478 |               "99051fe9-6a9c-46c2-b949-38ef78858dd1": false,
479 |               "registered_at": true,
480 |               "time": true
481 |             },
482 |             "indexByName": {
483 |               "location": 2,
484 |               "registered_at": 3,
485 |               "sensor_id": 0,
486 |               "temperature": 1
487 |             },
488 |             "renameByName": {
489 |               "99051fe9-6a9c-46c2-b949-38ef78858dd1": "Temperature",
490 |               "floor_number": "Floor №",
491 |               "id": "Sensor ID",
492 |               "location": "Location",
493 |               "room_name": "Room Name",
494 |               "sensor_id": "Sensor ID",
495 |               "temperature": "Temperature"
496 |             }
497 |           }
498 |         },
499 |         {
500 |           "id": "sortBy",
501 |           "options": {
502 |             "fields": {},
503 |             "sort": [
504 |               {
505 |                 "field": "Sensor ID"
506 |               }
507 |             ]
508 |           }
509 |         }
510 |       ],
511 |       "type": "table"
512 |     },
513 |     {
514 |       "datasource": {
515 |         "type": "hadesarchitect-cassandra-datasource",
516 |         "uid": "${DS_APACHE_CASSANDRA}"
517 |       },
518 |       "description": "This panel demonstrates the table mode of Apache Cassandra Datasource for Grafana",
519 |       "fieldConfig": {
520 |         "defaults": {
521 |           "color": {
522 |             "mode": "thresholds"
523 |           },
524 |           "custom": {
525 |             "align": "auto",
526 |             "cellOptions": {
527 |               "type": "auto"
528 |             },
529 |             "filterable": false,
530 |             "inspect": false
531 |           },
532 |           "mappings": [],
533 |           "thresholds": {
534 |             "mode": "absolute",
535 |             "steps": [
536 |               {
537 |                 "color": "green",
538 |                 "value": null
539 |               },
540 |               {
541 |                 "color": "red",
542 |                 "value": 80
543 |               }
544 |             ]
545 |           }
546 |         },
547 |         "overrides": [
548 |           {
549 |             "matcher": {
550 |               "id": "byName",
551 |               "options": "Temperature"
552 |             },
553 |             "properties": [
554 |               {
555 |                 "id": "custom.width",
556 |                 "value": 104
557 |               }
558 |             ]
559 |           },
560 |           {
561 |             "matcher": {
562 |               "id": "byName",
563 |               "options": "Sensor ID"
564 |             },
565 |             "properties": [
566 |               {
567 |                 "id": "custom.width",
568 |                 "value": 374
569 |               }
570 |             ]
571 |           }
572 |         ]
573 |       },
574 |       "gridPos": {
575 |         "h": 7,
576 |         "w": 12,
577 |         "x": 12,
578 |         "y": 8
579 |       },
580 |       "id": 6,
581 |       "options": {
582 |         "cellHeight": "sm",
583 |         "footer": {
584 |           "countRows": false,
585 |           "fields": [
586 |             "temperature"
587 |           ],
588 |           "reducer": [
589 |             "range"
590 |           ],
591 |           "show": true
592 |         },
593 |         "frameIndex": 0,
594 |         "showHeader": true,
595 |         "sortBy": []
596 |       },
597 |       "pluginVersion": "10.1.1",
598 |       "targets": [
599 |         {
600 |           "columnId": "sensor_id",
601 |           "columnTime": "registered_at",
602 |           "columnValue": "temperature",
603 |           "datasource": {
604 |             "type": "hadesarchitect-cassandra-datasource",
605 |             "uid": "${DS_APACHE_CASSANDRA}"
606 |           },
607 |           "datasourceId": 1,
608 |           "hide": false,
609 |           "instant": true,
610 |           "keyspace": "test",
611 |           "queryType": "query",
612 |           "refId": "A",
613 |           "table": "test",
614 |           "valueId": "99051fe9-6a9c-46c2-b949-38ef78858dd0, 99051fe9-6a9c-46c2-b949-38ef78858dd1"
615 |         }
616 |       ],
617 |       "title": "Table Configurator Demo",
618 |       "transformations": [
619 |         {
620 |           "id": "merge",
621 |           "options": {}
622 |         },
623 |         {
624 |           "id": "organize",
625 |           "options": {
626 |             "excludeByName": {
627 |               "99051fe9-6a9c-46c2-b949-38ef78858dd1": false,
628 |               "registered_at": true,
629 |               "time": true
630 |             },
631 |             "indexByName": {
632 |               "floor_number": 2,
633 |               "registered_at": 4,
634 |               "room_name": 1,
635 |               "sensor_id": 0,
636 |               "temperature": 3
637 |             },
638 |             "renameByName": {
639 |               "99051fe9-6a9c-46c2-b949-38ef78858dd1": "Temperature",
640 |               "floor_number": "Floor №",
641 |               "id": "Sensor ID",
642 |               "room_name": "Room Name",
643 |               "sensor_id": "Sensor ID",
644 |               "temperature": "Temperature"
645 |             }
646 |           }
647 |         },
648 |         {
649 |           "id": "sortBy",
650 |           "options": {
651 |             "fields": {},
652 |             "sort": [
653 |               {
654 |                 "field": "Sensor ID"
655 |               }
656 |             ]
657 |           }
658 |         }
659 |       ],
660 |       "type": "table"
661 |     }
662 |   ],
663 |   "refresh": "5s",
664 |   "schemaVersion": 38,
665 |   "style": "dark",
666 |   "tags": [],
667 |   "templating": {
668 |     "list": [
669 |       {
670 |         "current": {},
671 |         "datasource": {
672 |           "type": "hadesarchitect-cassandra-datasource",
673 |           "uid": "${DS_APACHE_CASSANDRA}"
674 |         },
675 |         "definition": "select sensor_id, location from test.sensors_locations",
676 |         "hide": 0,
677 |         "includeAll": false,
678 |         "label": "",
679 |         "multi": false,
680 |         "name": "loc",
681 |         "options": [],
682 |         "query": {
683 |           "rawQuery": "select sensor_id, location from test.sensors_locations"
684 |         },
685 |         "refresh": 1,
686 |         "regex": "",
687 |         "skipUrlSync": false,
688 |         "sort": 0,
689 |         "type": "query"
690 |       }
691 |     ]
692 |   },
693 |   "time": {
694 |     "from": "now-5m",
695 |     "to": "now"
696 |   },
697 |   "timepicker": {},
698 |   "timezone": "",
699 |   "title": "Cassandra Datasource Demo",
700 |   "uid": "g-XtNls7z",
701 |   "version": 21,
702 |   "weekStart": ""
703 | }


--------------------------------------------------------------------------------
/demo/docker-compose.yaml:
--------------------------------------------------------------------------------
 1 | services:
 2 |   grafana:
 3 |     build: .
 4 |     ports:
 5 |       - "3000:3000"
 6 |     environment:
 7 |       GF_LOG_LEVEL: debug
 8 |       GF_AUTH_ANONYMOUS_ORG_ROLE: Admin
 9 |       GF_AUTH_ANONYMOUS_ENABLED: "true"
10 |       GF_AUTH_BASIC_ENABLED: "false"
11 |       GF_DEFAULT_APP_MODE: development
12 |     volumes:
13 |       - ./grafana.db:/var/lib/grafana/grafana.db
14 |   cassandra:
15 |     image: cassandra:4
16 |     ports:
17 |       - "9042:9042"
18 |     volumes:
19 |       - /var/lib/cassandra
20 |   sample-data:
21 |     image: cassandra:4
22 |     depends_on:
23 |       - cassandra
24 |     restart: "no"
25 |     entrypoint: ["/sample_data.sh"]
26 |     volumes:
27 |       - ./sample_data.sh:/sample_data.sh
28 | 


--------------------------------------------------------------------------------
/demo/grafana.db:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/HadesArchitect/GrafanaCassandraDatasource/1c1bf128ecdf341a3e067c6c49329d61b5313a41/demo/grafana.db


--------------------------------------------------------------------------------
/demo/sample_data.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env bash
 2 | 
 3 | until printf "" 2>>/dev/null >>/dev/tcp/cassandra/9042; do 
 4 |     sleep 5;
 5 |     echo "Waiting for cassandra...";
 6 | done
 7 | 
 8 | echo "Creating keyspace and tables..."
 9 | cqlsh cassandra -e "CREATE KEYSPACE IF NOT EXISTS test WITH replication = {'class': 'SimpleStrategy', 'replication_factor': '1'};"
10 | cqlsh cassandra -e "CREATE TABLE IF NOT EXISTS test.test (sensor_id uuid, registered_at timestamp, temperature int, location text, PRIMARY KEY ((sensor_id), registered_at)) WITH CLUSTERING ORDER BY (registered_at DESC);"
11 | cqlsh cassandra -e "CREATE TABLE IF NOT EXISTS test.sensors_locations (bucket text, location text, sensor_id uuid, PRIMARY KEY((bucket), location));"
12 | 
13 | cqlsh cassandra -e "insert into test.sensors_locations (bucket, location, sensor_id) values ('default', 'kitchen', 99051fe9-6a9c-46c2-b949-38ef78858dd0);";
14 | cqlsh cassandra -e "insert into test.sensors_locations (bucket, location, sensor_id) values ('default', 'bedroom', 99051fe9-6a9c-46c2-b949-38ef78858dd1);";
15 | 
16 | while true; do
17 |     echo "Writing sample data...";
18 |     cqlsh cassandra -e "insert into test.test (sensor_id, registered_at, temperature, location) values (99051fe9-6a9c-46c2-b949-38ef78858dd0, toTimestamp(now()), $(shuf -i 18-32 -n 1), 'kitchen');";
19 |     cqlsh cassandra -e "insert into test.test (sensor_id, registered_at, temperature, location) values (99051fe9-6a9c-46c2-b949-38ef78858dd1, toTimestamp(now()), $(shuf -i 12-40 -n 1), 'bedroom');";
20 |     sleep 5;
21 | done
22 | 
23 | # cqlsh -e "SELECT cast(location as text), cast(sensor_id as text) from test.sensors_locations where bucket = 'default'"
24 | 


--------------------------------------------------------------------------------
/docker-compose.yaml:
--------------------------------------------------------------------------------
 1 | services:
 2 |   grafana:
 3 |     image: grafana/grafana:12.0.1
 4 |     ports:
 5 |       - "3000:3000"
 6 |     environment:
 7 |       GF_LOG_LEVEL: debug
 8 |       GF_AUTH_ANONYMOUS_ORG_ROLE: Admin
 9 |       GF_AUTH_ANONYMOUS_ENABLED: "true"
10 |       GF_AUTH_BASIC_ENABLED: "false"
11 |       GF_DEFAULT_APP_MODE: development
12 |       #GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS: hadesarchitect-cassandra-datasource
13 |     volumes:
14 |       - /var/lib/grafana
15 |       - ./dist:/var/lib/grafana/plugins/cassandra
16 |   cassandra:
17 |     image: cassandra:4
18 |     ports:
19 |       - "9042:9042"
20 |     volumes:
21 |       - /var/lib/cassandra
22 |   sample-data:
23 |     image: cassandra:4
24 |     depends_on:
25 |       - cassandra
26 |     restart: "no"
27 |     entrypoint: ["/sample_data.sh"]
28 |     volumes:
29 |       - ./demo/sample_data.sh:/sample_data.sh
30 | 


--------------------------------------------------------------------------------
/jest-setup.js:
--------------------------------------------------------------------------------
1 | // Jest setup provided by Grafana scaffolding
2 | import './.config/jest-setup';
3 | 


--------------------------------------------------------------------------------
/jest.config.js:
--------------------------------------------------------------------------------
1 | // force timezone to UTC to allow tests to work regardless of local timezone
2 | // generally used by snapshots, but can affect specific tests
3 | process.env.TZ = 'UTC';
4 | 
5 | module.exports = {
6 |   // Jest configuration provided by Grafana scaffolding
7 |   ...require('./.config/jest.config'),
8 | };
9 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "grafana-cassandra-datasource",
 3 |   "main": "dist/module",
 4 |   "version": "3.1.1",
 5 |   "license": "MIT",
 6 |   "repository": "https://github.com/HadesArchitect/GrafanaCassandraDatasource",
 7 |   "contributors": [
 8 |     {
 9 |       "name": "Aleksandr Volochnev",
10 |       "email": "a.volochnev@gmail.com",
11 |       "url": "https://www.linkedin.com/in/aleks-volochnev/"
12 |     },
13 |     {
14 |       "name": "Armen Khachkinaev",
15 |       "email": "armen114@yandex.ru",
16 |       "url": "https://www.linkedin.com/in/armen-khachkinaev/"
17 |     },
18 |     {
19 |       "name": "Vyacheslav Mitrofanov",
20 |       "email": "unflag@ymail.com",
21 |       "url": "https://www.linkedin.com/in/unflag/"
22 |     }
23 |   ],
24 |   "scripts": {
25 |     "build": "webpack -c ./.config/webpack/webpack.config.ts --env production",
26 |     "dev": "webpack -w -c ./.config/webpack/webpack.config.ts --env development",
27 |     "e2e": "yarn exec cypress install && yarn exec grafana-e2e run",
28 |     "e2e:update": "yarn exec cypress install && yarn exec grafana-e2e run --update-screenshots",
29 |     "lint": "eslint --cache --ignore-path ./.gitignore --ext .js,.jsx,.ts,.tsx .",
30 |     "lint:fix": "yarn run lint --fix",
31 |     "server": "docker-compose up --build",
32 |     "sign": "npx --yes @grafana/sign-plugin@latest",
33 |     "start": "yarn watch",
34 |     "test": "jest --watch --onlyChanged",
35 |     "test:ci": "jest --passWithNoTests --maxWorkers 4",
36 |     "typecheck": "tsc --noEmit"
37 |   },
38 |   "devDependencies": {
39 |     "@babel/core": "^7.27.1",
40 |     "@grafana/e2e": "10.4.12",
41 |     "@grafana/e2e-selectors": "10.4.19",
42 |     "@grafana/eslint-config": "^6.0.1",
43 |     "@grafana/tsconfig": "^2.0.0",
44 |     "@swc/core": "^1.11.29",
45 |     "@swc/helpers": "^0.5.13",
46 |     "@swc/jest": "^0.2.36",
47 |     "@testing-library/jest-dom": "^6.6.3",
48 |     "@testing-library/react": "^12.1.5",
49 |     "@types/jest": "^29.5.14",
50 |     "@types/lodash": "^4.17.13",
51 |     "@types/node": "^22.10.6",
52 |     "copy-webpack-plugin": "^12.0.2",
53 |     "css-loader": "^7.1.2",
54 |     "eslint-webpack-plugin": "^4.2.0",
55 |     "fork-ts-checker-webpack-plugin": "^9.0.2",
56 |     "glob": "^11.0.0",
57 |     "identity-obj-proxy": "3.0.0",
58 |     "jest": "^29.7.0",
59 |     "jest-environment-jsdom": "^29.7.0",
60 |     "prettier": "^3.4.2",
61 |     "react": "17.0.2",
62 |     "react-dom": "17.0.2",
63 |     "replace-in-file-webpack-plugin": "^1.0.6",
64 |     "sass": "^1.89.0",
65 |     "sass-loader": "^16.0.4",
66 |     "style-loader": "^4.0.0",
67 |     "swc-loader": "^0.2.6",
68 |     "ts-node": "^10.9.2",
69 |     "tsconfig-paths": "^4.2.0",
70 |     "typescript": "^5.8.3",
71 |     "webpack": "^5.99.9",
72 |     "webpack-cli": "^6.0.1",
73 |     "webpack-livereload-plugin": "^3.0.2"
74 |   },
75 |   "engines": {
76 |     "node": ">=18"
77 |   },
78 |   "dependencies": {
79 |     "@emotion/css": "^11.13.5",
80 |     "@grafana/data": "^10.4.19",
81 |     "@grafana/runtime": "^10.4.19",
82 |     "@grafana/ui": "^10.4.19",
83 |     "react": "17.0.2",
84 |     "react-dom": "17.0.2",
85 |     "tslib": "^2.8.1"
86 |   },
87 |   "packageManager": "yarn@1.22.19"
88 | }
89 | 


--------------------------------------------------------------------------------
/src/ConfigEditor.tsx:
--------------------------------------------------------------------------------
  1 | import React, { ChangeEvent, PureComponent } from 'react';
  2 | import { FieldSet, InlineField, InlineFieldRow, Input, LegacyForms, Select, InlineSwitch } from '@grafana/ui';
  3 | import { DataSourcePluginOptionsEditorProps } from '@grafana/data';
  4 | import { CassandraDataSourceOptions } from './models';
  5 | 
  6 | const { SecretFormField } = LegacyForms;
  7 | 
  8 | type Props = DataSourcePluginOptionsEditorProps<CassandraDataSourceOptions, Record<string, unknown>>;
  9 | 
 10 | interface State {}
 11 | 
 12 | export class ConfigEditor extends PureComponent<Props, State> {
 13 |   onHostChange = (event: ChangeEvent<HTMLInputElement>) => {
 14 |     if (event.target.value === '') {
 15 |       event.target.setCustomValidity('Cannot be empty');
 16 |       event.target.placeholder = 'This field cannot be empty!';
 17 |       event.target.style.setProperty('border-color', 'red');
 18 |     } else {
 19 |       event.target.setCustomValidity('');
 20 |       event.target.placeholder = 'cassandra:9042';
 21 |       event.target.style.setProperty('border-color', '');
 22 |     }
 23 |     const { onOptionsChange, options } = this.props;
 24 |     const url = event.target.value;
 25 |     onOptionsChange({ ...options, url });
 26 |   };
 27 | 
 28 |   onKeyspaceChange = (event: ChangeEvent<HTMLInputElement>) => {
 29 |     const { onOptionsChange, options } = this.props;
 30 |     const jsonData = {
 31 |       ...options.jsonData,
 32 |       keyspace: event.target.value,
 33 |     };
 34 |     onOptionsChange({ ...options, jsonData });
 35 |   };
 36 | 
 37 |   onAPIKeyChange = (event: ChangeEvent<HTMLInputElement>) => {
 38 |     const { onOptionsChange, options } = this.props;
 39 |     onOptionsChange({
 40 |       ...options,
 41 |       secureJsonData: {
 42 |         apiKey: event.target.value,
 43 |       },
 44 |     });
 45 |   };
 46 | 
 47 |   onUserChange = (event: ChangeEvent<HTMLInputElement>) => {
 48 |     const { onOptionsChange, options } = this.props;
 49 |     const jsonData = {
 50 |       ...options.jsonData,
 51 |       user: event.target.value,
 52 |     };
 53 |     onOptionsChange({ ...options, jsonData });
 54 |   };
 55 | 
 56 |   onTimeoutChange = (event: ChangeEvent<HTMLInputElement>) => {
 57 |     const { onOptionsChange, options } = this.props;
 58 |     const jsonData = {
 59 |       ...options.jsonData,
 60 |       timeout: Number(event.target.value),
 61 |     };
 62 |     onOptionsChange({ ...options, jsonData });
 63 |   };
 64 | 
 65 |   onUseCustomTLSChange = (event: React.FormEvent<HTMLInputElement>) => {
 66 |     const { onOptionsChange, options } = this.props;
 67 |     const jsonData = {
 68 |       ...options.jsonData,
 69 |       useCustomTLS: event.currentTarget.checked,
 70 |     };
 71 |     onOptionsChange({ ...options, jsonData });
 72 |   };
 73 | 
 74 |   onPasswordReset = () => {
 75 |     const { onOptionsChange, options } = this.props;
 76 |     onOptionsChange({
 77 |       ...options,
 78 |       secureJsonFields: {
 79 |         ...options.secureJsonFields,
 80 |         password: false,
 81 |       },
 82 |       secureJsonData: {
 83 |         ...options.secureJsonData,
 84 |         password: '',
 85 |       },
 86 |     });
 87 |   };
 88 | 
 89 |   onPasswordChange = (event: ChangeEvent<HTMLInputElement>) => {
 90 |     const { onOptionsChange, options } = this.props;
 91 |     onOptionsChange({
 92 |       ...options,
 93 |       secureJsonFields: {
 94 |         ...options.secureJsonFields,
 95 |         password: true,
 96 |       },
 97 |       secureJsonData: {
 98 |         ...options.secureJsonData,
 99 |         password: event.target.value,
100 |       },
101 |     });
102 |   };
103 | 
104 |   render() {
105 |     const { onOptionsChange, options } = this.props;
106 |     const { jsonData } = options;
107 | 
108 |     const consistencyOptions = [
109 |       { label: 'ONE', value: 'ONE' },
110 |       { label: 'TWO', value: 'TWO' },
111 |       { label: 'THREE', value: 'THREE' },
112 |       { label: 'QUORUM', value: 'QUORUM' },
113 |       { label: 'ALL', value: 'ALL' },
114 |       { label: 'LOCAL_QUORUM', value: 'LOCAL_QUORUM' },
115 |       { label: 'EACH_QUORUM', value: 'EACH_QUORUM' },
116 |       { label: 'LOCAL_ONE', value: 'LOCAL_ONE' },
117 |     ];
118 | 
119 |     if (!this.props.options.jsonData.consistency || this.props.options.jsonData.consistency === '') {
120 |       this.props.options.jsonData.consistency = consistencyOptions[0].value;
121 |     }
122 | 
123 |     return (
124 |       <>
125 |         <FieldSet label="Connection settings">
126 |           <InlineFieldRow>
127 |             <InlineField
128 |               label="Host"
129 |               labelWidth={20}
130 |               tooltip="Specify host and port like `192.168.12.134:9042`. You can specify multiple contact points using semicolon, f.e. `host1:9042;host2:9042;host3:9042`"
131 |             >
132 |               <Input
133 |                 name="host"
134 |                 value={options.url || ''}
135 |                 placeholder="cassandra:9042"
136 |                 invalid={options.url === ''}
137 |                 onChange={this.onHostChange}
138 |                 width={60}
139 |               />
140 |             </InlineField>
141 |           </InlineFieldRow>
142 |           <InlineFieldRow>
143 |             <InlineField label="Keyspace" labelWidth={20}>
144 |               <Input
145 |                 name="keyspace"
146 |                 value={options.jsonData.keyspace}
147 |                 placeholder="keyspace name"
148 |                 onChange={this.onKeyspaceChange}
149 |                 width={60}
150 |               />
151 |             </InlineField>
152 |           </InlineFieldRow>
153 |           <InlineFieldRow>
154 |             <InlineField label="Consistency" labelWidth={20}>
155 |               <Select
156 |                 placeholder="choose consistensy"
157 |                 options={consistencyOptions}
158 |                 isClearable={false}
159 |                 isSearchable={true}
160 |                 value={options.jsonData.consistency || consistencyOptions[0]}
161 |                 onChange={(value) => {
162 |                   jsonData.consistency = value.value!;
163 |                   onOptionsChange({ ...options, jsonData });
164 |                 }}
165 |                 width={60}
166 |               />
167 |             </InlineField>
168 |           </InlineFieldRow>
169 |           <InlineFieldRow>
170 |             <InlineField
171 |               label="Credentials"
172 |               tooltip="We strongly recommend to create a custom Cassandra user for Grafana with strictly read-only permissions!"
173 |               labelWidth={20}
174 |             >
175 |               <Input
176 |                 name="user"
177 |                 placeholder="user"
178 |                 value={options.jsonData.user}
179 |                 invalid={options.jsonData.user === ''}
180 |                 onChange={this.onUserChange}
181 |                 width={25}
182 |               />
183 |             </InlineField>
184 |             <InlineField>
185 |               <SecretFormField
186 |                 isConfigured={false}
187 |                 value={(options.secureJsonData?.password as string) || ''}
188 |                 onReset={this.onPasswordReset}
189 |                 onChange={this.onPasswordChange}
190 |                 labelWidth={5}
191 |               />
192 |             </InlineField>
193 |           </InlineFieldRow>
194 |           <InlineFieldRow>
195 |             <InlineField label="Timeout" labelWidth={20} tooltip="Timeout in seconds. Keep empty for the default value">
196 |               <Input
197 |                 name="timeout"
198 |                 placeholder=""
199 |                 type="number"
200 |                 step={1}
201 |                 value={options.jsonData.timeout}
202 |                 onChange={this.onTimeoutChange}
203 |                 width={60}
204 |               />
205 |             </InlineField>
206 |           </InlineFieldRow>
207 |         </FieldSet>
208 |         <FieldSet label="TLS Settings">
209 |           <InlineFieldRow>
210 |             <InlineField
211 |               label="Custom TLS settings"
212 |               tooltip="Enable if you need custom TLS configuration (usually required using AstraDB, AWS Keyspaces etc.)"
213 |               labelWidth={30}
214 |             >
215 |               <InlineSwitch value={options.jsonData.useCustomTLS} onChange={this.onUseCustomTLSChange} />
216 |             </InlineField>
217 |           </InlineFieldRow>
218 |           <InlineFieldRow>
219 |             <InlineField
220 |               label="Allow self-signed certificates"
221 |               labelWidth={30}
222 |               tooltip="Enable `custom TLS settings` to allow self-signed certificates"
223 |               disabled={!options.jsonData.useCustomTLS}
224 |             >
225 |               <InlineSwitch
226 |                 value={options.jsonData.allowInsecureTLS}
227 |                 onChange={(event: React.FormEvent<HTMLInputElement>) => {
228 |                   const jsonData = {
229 |                     ...options.jsonData,
230 |                     allowInsecureTLS: event.currentTarget.checked,
231 |                   };
232 |                   onOptionsChange({ ...options, jsonData });
233 |                 }}
234 |               />
235 |             </InlineField>
236 |           </InlineFieldRow>
237 |           <InlineFieldRow>
238 |             <InlineField
239 |               label="Certificate Path"
240 |               labelWidth={30}
241 |               disabled={!options.jsonData.useCustomTLS}
242 |               tooltip="Enable `custom TLS settings` to configure certificates"
243 |             >
244 |               <Input
245 |                 value={options.jsonData.certPath}
246 |                 placeholder="certificate path"
247 |                 onChange={(event: ChangeEvent<HTMLInputElement>) => {
248 |                   const jsonData = {
249 |                     ...options.jsonData,
250 |                     certPath: event.currentTarget.value,
251 |                   };
252 |                   onOptionsChange({ ...options, jsonData });
253 |                 }}
254 |                 width={60}
255 |               />
256 |             </InlineField>
257 |           </InlineFieldRow>
258 |           <InlineFieldRow>
259 |             <InlineField
260 |               label="Root Certificate Path"
261 |               labelWidth={30}
262 |               disabled={!options.jsonData.useCustomTLS}
263 |               tooltip="Enable `custom TLS settings` to configure certificates"
264 |             >
265 |               <Input
266 |                 value={options.jsonData.rootPath}
267 |                 placeholder="root certificate path"
268 |                 onChange={(event: ChangeEvent<HTMLInputElement>) => {
269 |                   const jsonData = {
270 |                     ...options.jsonData,
271 |                     rootPath: event.currentTarget.value,
272 |                   };
273 |                   onOptionsChange({ ...options, jsonData });
274 |                 }}
275 |                 width={60}
276 |               />
277 |             </InlineField>
278 |           </InlineFieldRow>
279 |           <InlineFieldRow>
280 |             <InlineField
281 |               label="RootCA Certificate Path"
282 |               labelWidth={30}
283 |               disabled={!options.jsonData.useCustomTLS}
284 |               tooltip="Enable `custom TLS settings` to configure certificates"
285 |             >
286 |               <Input
287 |                 value={options.jsonData.caPath}
288 |                 placeholder="CA certificate path"
289 |                 onChange={(event: ChangeEvent<HTMLInputElement>) => {
290 |                   const jsonData = {
291 |                     ...options.jsonData,
292 |                     caPath: event.currentTarget.value,
293 |                   };
294 |                   onOptionsChange({ ...options, jsonData });
295 |                 }}
296 |                 width={60}
297 |               />
298 |             </InlineField>
299 |           </InlineFieldRow>
300 |         </FieldSet>
301 |       </>
302 |     );
303 |   }
304 | }
305 | 


--------------------------------------------------------------------------------
/src/QueryEditor.tsx:
--------------------------------------------------------------------------------
  1 | import React, { ChangeEvent, PureComponent, FormEvent } from 'react';
  2 | import { Button, InlineField, InlineFieldRow, Input, InlineSwitch, Select, TextArea } from '@grafana/ui';
  3 | import { CoreApp, QueryEditorProps, SelectableValue } from '@grafana/data';
  4 | import { CassandraDatasource } from './datasource';
  5 | import { CassandraQuery, CassandraDataSourceOptions } from './models';
  6 | 
  7 | type Props = QueryEditorProps<CassandraDatasource, CassandraQuery, CassandraDataSourceOptions>;
  8 | 
  9 | function selectable(value?: string): SelectableValue<string> {
 10 |   if (!value) {
 11 |     return {};
 12 |   }
 13 | 
 14 |   return { label: value, value: value };
 15 | }
 16 | 
 17 | export class QueryEditor extends PureComponent<Props> {
 18 |   constructor(props: QueryEditorProps<CassandraDatasource, CassandraQuery, CassandraDataSourceOptions>) {
 19 |     super(props);
 20 | 
 21 |     const { onChange, query } = this.props;
 22 |     onChange({ ...query, datasourceId: props.datasource.id });
 23 |   }
 24 | 
 25 |   componentDidMount() {
 26 |     // Warm up the datasource cache on initialization.
 27 |     this.props.datasource.getKeyspaces().catch(error => {
 28 |       console.warn('QueryEditor: Failed to warm up keyspace cache on mount', error);
 29 |     });
 30 |   }
 31 | 
 32 |   onRunQuery(
 33 |     props: Readonly<Props> &
 34 |       Readonly<{
 35 |         children?: React.ReactNode;
 36 |       }>
 37 |   ) {
 38 |     this.props.query.queryType = 'query';
 39 |     if (this.props.app && this.props.app === CoreApp.UnifiedAlerting) {
 40 |       this.props.query.queryType = 'alert';
 41 |     }
 42 | 
 43 |     const { onChange, query } = this.props;
 44 |     onChange({ ...query, queryType: props.query.queryType });
 45 | 
 46 |     if ((
 47 |       props.query.keyspace &&
 48 |       props.query.keyspace !== '' &&
 49 |       props.query.table &&
 50 |       props.query.table !== '' &&
 51 |       props.query.columnTime &&
 52 |       props.query.columnTime !== '' &&
 53 |       props.query.columnValue &&
 54 |       props.query.columnValue !== '' &&
 55 |       props.query.columnId &&
 56 |       props.query.columnId !== '' &&
 57 |       props.query.valueId &&
 58 |       props.query.valueId !== ''
 59 |       ) || (props.query.target && props.query.target !== ''))
 60 |     {
 61 |       this.props.onRunQuery();
 62 |     }
 63 |   }
 64 | 
 65 |   getKeyspaces(): Array<SelectableValue<string>> {
 66 |     const result: Array<SelectableValue<string>> = [];
 67 |     this.props.datasource.getKeyspaces().then((keyspaces: string[]) => {
 68 |       keyspaces.forEach((keyspace: string) => {
 69 |         result.push({ label: keyspace, value: keyspace });
 70 |       });
 71 |     });
 72 | 
 73 |     return result;
 74 |   }
 75 | 
 76 |   getTables(): Array<SelectableValue<string>> {
 77 |     if (!this.props.query.keyspace) {
 78 |       return [];
 79 |     }
 80 | 
 81 |     const result: Array<SelectableValue<string>> = [];
 82 |     this.props.datasource.getTables(this.props.query.keyspace).then((tables: string[]) => {
 83 |       tables.forEach((table: string) => {
 84 |         result.push({ label: table, value: table });
 85 |       });
 86 |     });
 87 | 
 88 |     return result;
 89 |   }
 90 | 
 91 |   getOptions(needType: string): Array<SelectableValue<string>> {
 92 |     if (!this.props.query.keyspace || !this.props.query.table) {
 93 |       return [];
 94 |     }
 95 | 
 96 |     const columnOptions: Array<SelectableValue<string>> = [];
 97 | 
 98 |     this.props.datasource
 99 |       .getColumns(this.props.query.keyspace, this.props.query.table, needType)
100 |       .then((columns: string[]) => {
101 |         columns.forEach((column: string) => {
102 |           columnOptions.push({ label: column, value: column });
103 |         });
104 |       });
105 | 
106 |     return columnOptions;
107 |   }
108 | 
109 |   onChangeQueryType = () => {
110 |     const { onChange, query } = this.props;
111 |     onChange({ ...query, rawQuery: !query.rawQuery });
112 |   };
113 | 
114 |   onQueryTextChange = (e: FormEvent<HTMLInputElement | HTMLTextAreaElement>) => {
115 |     const { onChange, query } = this.props;
116 |     const { value } = e.target as HTMLInputElement | HTMLTextAreaElement;
117 |     onChange({ ...query, target: value });
118 |   };
119 | 
120 |   onKeyspaceChange = (event: SelectableValue<string>) => {
121 |     const { onChange, query } = this.props;
122 |     onChange({ ...query, keyspace: event.value });
123 |   };
124 | 
125 |   onTableChange = (event: SelectableValue<string>) => {
126 |     const { onChange, query } = this.props;
127 |     onChange({ ...query, table: event.value });
128 |   };
129 | 
130 |   onTimeColumnChange = (value: SelectableValue<string>) => {
131 |     const { onChange, query } = this.props;
132 |     onChange({ ...query, columnTime: value.value });
133 |   };
134 | 
135 |   onValueColumnChange = (event: SelectableValue<string>) => {
136 |     const { onChange, query } = this.props;
137 |     onChange({ ...query, columnValue: event.value });
138 |   };
139 | 
140 |   onIDColumnChange = (event: SelectableValue<string>) => {
141 |     const { onChange, query } = this.props;
142 |     onChange({ ...query, columnId: event.value });
143 |   };
144 | 
145 |   onIDValueChange = (event: ChangeEvent<HTMLInputElement>) => {
146 |     const { onChange, query } = this.props;
147 |     onChange({ ...query, valueId: event.target.value });
148 |   };
149 | 
150 |   onAliasChange = (event: ChangeEvent<HTMLInputElement>) => {
151 |     const { onChange, query } = this.props;
152 |     onChange({ ...query, alias: event.target.value });
153 |   };
154 | 
155 |   onFilteringChange = (event: ChangeEvent<HTMLInputElement>) => {
156 |     const { onChange, query } = this.props;
157 |     onChange({ ...query, filtering: event.target.checked });
158 |   };
159 | 
160 |   onInstantChange = (event: ChangeEvent<HTMLInputElement>) => {
161 |     const { onChange, query } = this.props;
162 |     onChange({ ...query, instant: event.target.checked });
163 |   };
164 | 
165 |   render() {
166 |     const options = this.props;
167 | 
168 |     return (
169 |       <div>
170 |         {options.query.rawQuery && (
171 |           <>
172 |             <InlineFieldRow>
173 |               <InlineField
174 |                 label="Cassandra CQL Query"
175 |                 labelWidth={30}
176 |                 tooltip="Enter Cassandra CQL query. There are $__timeFrom/$__timeTo, $__unixEpochFrom/$__unixEpochTo and $__from/$__to variables to dynamically limit time range in queries. You should always use them to avoid excessive data fetching from DB."
177 |                 grow
178 |               >
179 |                 <TextArea
180 |                   placeholder={'Enter a CQL query'}
181 |                   onChange={this.onQueryTextChange}
182 |                   onBlur={() => {
183 |                     this.onRunQuery(this.props);
184 |                   }}
185 |                   value={this.props.query.target}
186 |                 />
187 |               </InlineField>
188 |               <Button icon="pen" variant="secondary" aria-label="Toggle editor mode" onClick={this.onChangeQueryType} />
189 |             </InlineFieldRow>
190 |             <InlineFieldRow>
191 |               <InlineField label="Alias" labelWidth={30} tooltip="Series name override. Plain text or template using column names, e.g. `{{ column1 }}:{{ column2}}`">
192 |                 <Input
193 |                     name="alias"
194 |                     onChange={this.onAliasChange}
195 |                     onBlur={() => {
196 |                       this.onRunQuery(this.props);
197 |                     }}
198 |                     value={this.props.query.alias || ''}
199 |                 />
200 |               </InlineField>
201 |             </InlineFieldRow>
202 |           </>
203 |         )}
204 |         {!options.query.rawQuery && (
205 |           <>
206 |             <InlineFieldRow>
207 |               <InlineField label="Keyspace" labelWidth={30} tooltip="Specify keyspace to work with">
208 |                 <Select
209 |                   allowCustomValue={true}
210 |                   value={selectable(this.props.query.keyspace)}
211 |                   placeholder="keyspace name"
212 |                   onChange={this.onKeyspaceChange}
213 |                   options={this.getKeyspaces()}
214 |                   onBlur={() => {
215 |                     this.onRunQuery(this.props);
216 |                   }}
217 |                   width={90}
218 |                 />
219 |               </InlineField>
220 |               <Button icon="pen" variant="secondary" aria-label="Toggle editor mode" onClick={this.onChangeQueryType} />
221 |             </InlineFieldRow>
222 |             <InlineFieldRow>
223 |               <InlineField label="Table" labelWidth={30} tooltip="Specify table to work with">
224 |                 <Select
225 |                   allowCustomValue={true}
226 |                   value={selectable(this.props.query.table)}
227 |                   placeholder="table name"
228 |                   onChange={this.onTableChange}
229 |                   options={this.getTables()}
230 |                   onBlur={() => {
231 |                     this.onRunQuery(this.props);
232 |                   }}
233 |                   width={90}
234 |                 />
235 |               </InlineField>
236 |             </InlineFieldRow>
237 |             <InlineFieldRow>
238 |               <InlineField
239 |                 label="Time Column"
240 |                 labelWidth={30}
241 |                 tooltip="Specify name of a timestamp column to identify time (created_at, time etc.)"
242 |               >
243 |                 <Select
244 |                   allowCustomValue={true}
245 |                   value={selectable(this.props.query.columnTime)}
246 |                   placeholder="time column"
247 |                   onChange={this.onTimeColumnChange}
248 |                   onBlur={() => {
249 |                     this.onRunQuery(this.props);
250 |                   }}
251 |                   options={this.getOptions('timestamp')}
252 |                   width={90}
253 |                 />
254 |               </InlineField>
255 |             </InlineFieldRow>
256 |             <InlineFieldRow>
257 |               <InlineField
258 |                 label="Value Column"
259 |                 labelWidth={30}
260 |                 tooltip="Specify name of a numeric column to retrieve value (temperature, price etc.)"
261 |               >
262 |                 <Select
263 |                   allowCustomValue={true}
264 |                   placeholder="value column"
265 |                   value={selectable(this.props.query.columnValue)}
266 |                   options={this.getOptions('int')}
267 |                   onChange={this.onValueColumnChange}
268 |                   onBlur={() => {
269 |                     this.onRunQuery(this.props);
270 |                   }}
271 |                   width={90}
272 |                 />
273 |               </InlineField>
274 |             </InlineFieldRow>
275 |             <InlineFieldRow>
276 |               <InlineField
277 |                 label="ID Column"
278 |                 labelWidth={30}
279 |                 tooltip="Specify name of a ID column to identify the row (id, sensor_id etc.)"
280 |               >
281 |                 <Select
282 |                   allowCustomValue={true}
283 |                   placeholder="ID column"
284 |                   value={selectable(this.props.query.columnId)}
285 |                   onChange={this.onIDColumnChange}
286 |                   onBlur={() => {
287 |                     this.onRunQuery(this.props);
288 |                   }}
289 |                   options={this.getOptions('uuid')}
290 |                   width={90}
291 |                 />
292 |               </InlineField>
293 |             </InlineFieldRow>
294 |             <InlineFieldRow>
295 |               <InlineField
296 |                 label="ID Value"
297 |                 labelWidth={30}
298 |                 tooltip="Specify UUID value of a column to identify the row (f.e. 123e4567-e89b-12d3-a456-426655440000)"
299 |               >
300 |                 <Input
301 |                   name="value_column"
302 |                   placeholder="123e4567-e89b-12d3-a456-426655440000"
303 |                   value={this.props.query.valueId || ''}
304 |                   onChange={this.onIDValueChange}
305 |                   onBlur={() => {
306 |                     this.onRunQuery(this.props);
307 |                   }}
308 |                   width={90}
309 |                   required
310 |                 />
311 |               </InlineField>
312 |             </InlineFieldRow>
313 |             <InlineFieldRow>
314 |               <InlineField label="Alias" labelWidth={30} tooltip="Series name override. Plain text or template using column names, e.g. `{{ column1 }}:{{ column2}}`">
315 |                 <Input
316 |                   name="alias"
317 |                   placeholder="my alias"
318 |                   value={this.props.query.alias || ''}
319 |                   onChange={this.onAliasChange}
320 |                   onBlur={() => {
321 |                     this.onRunQuery(this.props);
322 |                   }}
323 |                   width={90}
324 |                 />
325 |               </InlineField>
326 |             </InlineFieldRow>
327 |             <InlineFieldRow>
328 |               <InlineField
329 |                   label="Instant"
330 |                   labelWidth={30}
331 |                   tooltip="Queries only first point for each series(PER PARTITION LIMIT 1)"
332 |               >
333 |                 <InlineSwitch
334 |                     value={this.props.query.instant}
335 |                     onChange={this.onInstantChange}
336 |                     onBlur={() => {
337 |                       this.onRunQuery(this.props);
338 |                     }}
339 |                 />
340 |               </InlineField>
341 |             </InlineFieldRow>
342 |             <InlineFieldRow>
343 |               <InlineField
344 |                 label="Allow filtering"
345 |                 labelWidth={30}
346 |                 tooltip="Allow Filtering can be dangerous practice and we strongly discourage using it"
347 |               >
348 |                 <InlineSwitch
349 |                   value={this.props.query.filtering}
350 |                   onChange={this.onFilteringChange}
351 |                   onBlur={() => {
352 |                     this.onRunQuery(this.props);
353 |                   }}
354 |                 />
355 |               </InlineField>
356 |             </InlineFieldRow>
357 |           </>
358 |         )}
359 |       </div>
360 |     );
361 |   }
362 | }
363 | 


--------------------------------------------------------------------------------
/src/VariableQueryEditor.tsx:
--------------------------------------------------------------------------------
 1 | import React, { useState } from 'react';
 2 | import { CassandraVariableQuery } from './models';
 3 | import { TextArea } from '@grafana/ui';
 4 | 
 5 | interface VariableQueryProps {
 6 |   query: CassandraVariableQuery;
 7 |   onChange: (query: CassandraVariableQuery, definition: string) => void;
 8 | }
 9 | 
10 | export const VariableQueryEditor = ({ onChange, query }: VariableQueryProps) => {
11 |   const [state, setState] = useState(query);
12 | 
13 |   const saveQuery = () => {
14 |     onChange(state, `${state.query}`);
15 |   };
16 | 
17 |   const handleChange = (event: React.FormEvent<HTMLTextAreaElement>) =>
18 |     setState({
19 |       ...state,
20 |       [event.currentTarget.name]: event.currentTarget.value,
21 |     });
22 | 
23 |   return (
24 |     <>
25 |         <label className="small">Specify a query that returns variable values and, optionally, their labels. Only strings are allowed here, so use CAST(column as text) if needed. First returned column interpreted as a value and second as a label. Labels should be used in cases when there is an intention to hide exact variable values behind human-readable names in the Grafana UI.</label>
26 |         <br />
27 |         <TextArea
28 |           name="query"
29 |           className="gf-form-input"
30 |           onBlur={saveQuery}
31 |           onChange={handleChange}
32 |           value={state.query}
33 |           placeholder={'SELECT sensor_id, location FROM sensors.sensors_locations'}
34 |         />
35 |     </>
36 |   );
37 | };
38 | 


--------------------------------------------------------------------------------
/src/datasource.ts:
--------------------------------------------------------------------------------
  1 | import _ from 'lodash';
  2 | import { DataSourceWithBackend, getTemplateSrv } from '@grafana/runtime';
  3 | import {DataQueryRequest, DataQueryResponse, DataSourceInstanceSettings} from '@grafana/data';
  4 | import { CassandraQuery,CassandraVariableQuery, CassandraDataSourceOptions } from './models';
  5 | import { Observable } from 'rxjs';
  6 | 
  7 | export class CassandraDatasource extends DataSourceWithBackend<CassandraQuery, CassandraDataSourceOptions> {
  8 |   headers: any;
  9 |   id: number;
 10 |   private keyspaces: string[] = [];
 11 | 
 12 |   constructor(instanceSettings: DataSourceInstanceSettings<CassandraDataSourceOptions>) {
 13 |     super(instanceSettings);
 14 | 
 15 |     this.headers = { 'Content-Type': 'application/json' };
 16 | 
 17 |     this.id = instanceSettings.id;
 18 | 
 19 |     // annotations default behaviour
 20 |     // https://grafana.com/docs/grafana/latest/developers/plugins/create-a-grafana-plugin/extend-a-plugin/add-support-for-annotations/
 21 |     this.annotations = {};
 22 |   }
 23 | 
 24 |   query(options: DataQueryRequest<CassandraQuery>): Observable<DataQueryResponse> {
 25 |     if (this.isEditorMode(options)) {
 26 |       if (!this.isEditorCompleted(options)) {
 27 |         throw new Error('Skipping query execution while not all editor fields are filled');
 28 |       }
 29 |     } else {
 30 |       if (!this.isConfiguratorCompleted(options)) {
 31 |         throw new Error('Skipping query execution while not all configurator fields are filled');
 32 |       }
 33 |     }
 34 | 
 35 |     return super.query(this.buildQueryParameters(options));
 36 |   }
 37 | 
 38 |   // metricFindQuery implicitly returns array of MetricFindValue objects. It assumed, that
 39 |   // backend returns some compatible type to be correctly used in dashboard variables context.
 40 |   // https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/datasource.ts#L595
 41 |   async metricFindQuery(query: CassandraVariableQuery, options?: any) {
 42 |     const response = await this.getResource('variables', {query: query.query});
 43 |     return response;
 44 |   }
 45 | 
 46 |   isEditorMode(options: DataQueryRequest<CassandraQuery>): boolean {
 47 |     return !options.targets[0].rawQuery;
 48 |   }
 49 | 
 50 |   isEditorCompleted(options: DataQueryRequest<CassandraQuery>): boolean {
 51 |     return Boolean(
 52 |       options.targets[0].keyspace &&
 53 |       options.targets[0].table &&
 54 |       options.targets[0].columnTime &&
 55 |       options.targets[0].columnValue &&
 56 |       options.targets[0].columnId &&
 57 |       options.targets[0].valueId
 58 |     );
 59 |   }
 60 | 
 61 |   isConfiguratorCompleted(options: DataQueryRequest<CassandraQuery>): boolean {
 62 |     return Boolean(options.targets[0].target);
 63 |   }
 64 | 
 65 |   async getKeyspaces(): Promise<string[]> {
 66 |     if (0 !== this.keyspaces.length) {
 67 |       return this.keyspaces;
 68 |     }
 69 | 
 70 |     try {
 71 |       this.keyspaces = await this.getResource('keyspaces');
 72 |       return this.keyspaces;
 73 |     } catch (error) {
 74 |       console.warn('Failed to fetch keyspaces:', error);
 75 |       return [];
 76 |     }
 77 |   }
 78 | 
 79 |   async getTables(keyspace: string): Promise<string[]> {
 80 |     return this.getResource('tables', { keyspace: keyspace });
 81 |   }
 82 | 
 83 |   async getColumns(keyspace: string, table: string, needType: string): Promise<string[]> {
 84 |     return this.getResource('columns', {
 85 |       keyspace: keyspace,
 86 |       table: table,
 87 |       needType: needType,
 88 |     });
 89 |   }
 90 | 
 91 |   buildQueryParameters(options: DataQueryRequest<CassandraQuery>): DataQueryRequest<CassandraQuery> {
 92 |     //remove placeholder targets
 93 |     options.targets = _.filter(options.targets, (target) => {
 94 |       return target.target !== 'select metric';
 95 |     });
 96 | 
 97 |     const targets: CassandraQuery[] = _.map(options.targets, (target) => {
 98 |       return {
 99 |         datasourceId: target.datasourceId,
100 |         queryType: target.queryType,
101 | 
102 |         target: getTemplateSrv().replace(target.target, options.scopedVars, 'csv'),
103 |         refId: target.refId,
104 |         hide: target.hide,
105 |         rawQuery: target.rawQuery,
106 |         filtering: target.filtering,
107 |         keyspace: target.keyspace,
108 |         table: target.table,
109 |         columnTime: target.columnTime,
110 |         columnValue: target.columnValue,
111 |         columnId: target.columnId,
112 |         valueId:  getTemplateSrv().replace(target.valueId, options.scopedVars, 'csv'),
113 |         alias: target.alias,
114 |         instant: target.instant,
115 |       };
116 |     });
117 | 
118 |     options.targets = targets;
119 | 
120 |     return options;
121 |   }
122 | }
123 | 


--------------------------------------------------------------------------------
/src/img/cassandra.svg:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2 | <!-- Created with Inkscape (http://www.inkscape.org/) -->
  3 | 
  4 | <svg
  5 |    xmlns:dc="http://purl.org/dc/elements/1.1/"
  6 |    xmlns:cc="http://creativecommons.org/ns#"
  7 |    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  8 |    xmlns:svg="http://www.w3.org/2000/svg"
  9 |    xmlns="http://www.w3.org/2000/svg"
 10 |    version="1.1"
 11 |    width="279.18411"
 12 |    height="187.47701"
 13 |    id="svg2816"
 14 |    style="background-color: white;"
 15 |    xml:space="preserve"><title
 16 |      id="title3537">Apache Cassandra</title><metadata
 17 |      id="metadata2822"><rdf:RDF><cc:Work
 18 |          rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
 19 |            rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title>Apache Cassandra</dc:title><cc:license
 20 |            rdf:resource="Apache License" /><dc:creator><cc:Agent><dc:title>Apache Software Foundation</dc:title></cc:Agent></dc:creator><dc:source>https://svn.apache.org/repos/asf/cassandra/logo/cassandra.svg</dc:source></cc:Work></rdf:RDF></metadata><defs
 21 |      id="defs2820"><clipPath
 22 |        id="clipPath2832"><path
 23 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 24 |          id="path2834" /></clipPath><clipPath
 25 |        id="clipPath2844"><path
 26 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 27 |          id="path2846" /></clipPath><clipPath
 28 |        id="clipPath2852"><path
 29 |          d="m 96.0078,715.93 88.2902,0 0,-62.176 -88.2902,0 0,62.176 z"
 30 |          id="path2854" /></clipPath><clipPath
 31 |        id="clipPath2868"><path
 32 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 33 |          id="path2870" /></clipPath><clipPath
 34 |        id="clipPath2880"><path
 35 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 36 |          id="path2882" /></clipPath><clipPath
 37 |        id="clipPath2908"><path
 38 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 39 |          id="path2910" /></clipPath><clipPath
 40 |        id="clipPath2936"><path
 41 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 42 |          id="path2938" /></clipPath><clipPath
 43 |        id="clipPath2944"><path
 44 |          d="m 121.202,708.378 45.899,0 0,-45.859 -45.899,0 0,45.859 z"
 45 |          id="path2946" /></clipPath><clipPath
 46 |        id="clipPath2960"><path
 47 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 48 |          id="path2962" /></clipPath><clipPath
 49 |        id="clipPath2968"><path
 50 |          d="m 40.4033,726.188 212.4017,0 0,-61.818 -212.4017,0 0,61.818 z"
 51 |          id="path2970" /></clipPath><clipPath
 52 |        id="clipPath2988"><path
 53 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 54 |          id="path2990" /></clipPath><clipPath
 55 |        id="clipPath2996"><path
 56 |          d="m 39.5195,688.644 199.3805,0 0,-73.818 -199.3805,0 0,73.818 z"
 57 |          id="path2998" /></clipPath><clipPath
 58 |        id="clipPath3016"><path
 59 |          d="M 0,792 612,792 612,0 0,0 0,792 z"
 60 |          id="path3018" /></clipPath></defs><g
 61 |      transform="translate(-62.668647,-74.06425)"
 62 |      id="layer1"
 63 |      style="display:inline"><g
 64 |    transform="matrix(1.25,0,0,-1.25,19.117647,990)"
 65 |    id="g3012"><g
 66 |      clip-path="url(#clipPath3016)"
 67 |      id="g3014"><g
 68 |        transform="translate(61.4912,609.1372)"
 69 |        id="g3020"><path
 70 |          d="M 0,0 C 1.824,0 3.552,-0.432 4.417,-1.296 4.561,-2.641 3.36,-4.801 2.592,-4.801 1.68,-4.465 0.816,-4.272 -0.24,-4.272 c -4.368,0 -6.529,-4.513 -6.529,-8.977 0,-2.784 0.96,-4.465 3.169,-4.465 2.352,0 4.752,1.584 6.096,2.784 0.336,-0.239 0.768,-1.008 0.768,-1.872 0,-0.96 -0.288,-1.872 -1.152,-2.736 -1.536,-1.536 -4.128,-2.832 -7.873,-2.832 -4.32,0 -7.296,2.448 -7.296,8.161 C -13.057,-6.721 -8.113,0 -0.048,0 L 0,0 z"
 71 |          id="path3022"
 72 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 73 |        transform="translate(75.6021,591.6636)"
 74 |        id="g3024"><path
 75 |          d="m 0,0 c 2.352,0 6.625,4.129 7.825,12.001 0.048,0.48 0.096,0.624 0.192,1.104 -0.528,0.192 -1.248,0.336 -1.969,0.336 -1.776,0 -3.6,-0.528 -5.232,-2.736 -1.68,-2.352 -2.4,-5.28 -2.4,-7.633 C -1.584,1.057 -1.008,0 -0.048,0 L 0,0 z m -7.729,2.16 c 0,2.832 0.96,7.777 4.561,11.377 3.072,3.168 6.816,3.937 10.225,3.937 2.256,0 5.328,-0.72 7.248,-1.105 -0.48,-2.112 -1.632,-10.08 -2.16,-14.688 -0.24,-1.969 -0.336,-4.705 -0.24,-5.713 -1.584,-0.672 -4.56,-0.864 -5.377,-0.864 -0.431,0 -0.528,1.968 -0.383,3.84 0.047,0.624 0.144,1.536 0.191,1.92 -1.872,-3.12 -5.568,-5.76 -9.456,-5.76 -2.784,0 -4.609,2.304 -4.609,7.008 l 0,0.048 z"
 76 |          id="path3026"
 77 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 78 |        transform="translate(101.8579,609.1372)"
 79 |        id="g3028"><path
 80 |          d="m 0,0 c 1.968,0 3.84,-0.72 4.705,-1.632 -0.048,-1.345 -1.104,-3.6 -2.785,-2.976 -0.72,0.24 -1.44,0.431 -2.4,0.431 -1.296,0 -2.4,-0.576 -2.4,-1.775 0,-0.912 0.672,-1.585 3.888,-3.841 2.305,-1.68 3.217,-3.168 3.217,-5.28 0,-3.505 -3.313,-7.297 -9.073,-7.297 -2.352,0 -4.417,0.912 -5.089,1.872 -0.864,1.44 -0.192,4.272 0.769,3.793 1.248,-0.624 3.312,-1.297 4.992,-1.297 1.584,0 2.592,0.721 2.592,1.681 0,0.815 -0.72,1.536 -3.648,3.6 -2.449,1.824 -3.217,3.504 -3.217,5.424 0,3.984 3.409,7.297 8.401,7.297 L 0,0 z"
 81 |          id="path3030"
 82 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 83 |        transform="translate(118.417,609.1372)"
 84 |        id="g3032"><path
 85 |          d="m 0,0 c 1.969,0 3.841,-0.72 4.705,-1.632 -0.048,-1.345 -1.103,-3.6 -2.784,-2.976 -0.72,0.24 -1.441,0.431 -2.4,0.431 -1.296,0 -2.4,-0.576 -2.4,-1.775 0,-0.912 0.672,-1.585 3.888,-3.841 2.304,-1.68 3.216,-3.168 3.216,-5.28 0,-3.505 -3.313,-7.297 -9.073,-7.297 -2.352,0 -4.416,0.912 -5.088,1.872 -0.864,1.44 -0.192,4.272 0.768,3.793 1.248,-0.624 3.312,-1.297 4.992,-1.297 1.584,0 2.592,0.721 2.592,1.681 0,0.815 -0.72,1.536 -3.648,3.6 -2.448,1.824 -3.216,3.504 -3.216,5.424 0,3.984 3.408,7.297 8.401,7.297 L 0,0 z"
 86 |          id="path3034"
 87 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 88 |        transform="translate(133.5361,591.6636)"
 89 |        id="g3036"><path
 90 |          d="m 0,0 c 2.353,0 6.625,4.129 7.825,12.001 0.048,0.48 0.097,0.624 0.193,1.104 -0.529,0.192 -1.248,0.336 -1.969,0.336 -1.776,0 -3.6,-0.528 -5.233,-2.736 -1.679,-2.352 -2.4,-5.28 -2.4,-7.633 C -1.584,1.057 -1.008,0 -0.047,0 L 0,0 z m -7.729,2.16 c 0,2.832 0.961,7.777 4.561,11.377 3.072,3.168 6.816,3.937 10.225,3.937 2.256,0 5.329,-0.72 7.249,-1.105 -0.48,-2.112 -1.632,-10.08 -2.16,-14.688 -0.241,-1.969 -0.336,-4.705 -0.241,-5.713 -1.584,-0.672 -4.559,-0.864 -5.376,-0.864 -0.431,0 -0.528,1.968 -0.384,3.84 0.048,0.624 0.144,1.536 0.192,1.92 -1.872,-3.12 -5.568,-5.76 -9.456,-5.76 -2.785,0 -4.61,2.304 -4.61,7.008 l 0,0.048 z"
 91 |          id="path3038"
 92 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 93 |        transform="translate(158.688,602.897)"
 94 |        id="g3040"><path
 95 |          d="m 0,0 c 2.209,3.552 5.088,6.24 9.121,6.24 3.408,0 4.512,-3.168 3.889,-7.68 -0.336,-2.113 -0.912,-5.137 -1.297,-7.921 -0.336,-2.353 -0.576,-4.464 -0.527,-5.905 -1.248,-0.624 -4.897,-0.864 -5.713,-0.864 -0.336,0 -0.385,2.641 0.048,5.425 0.383,2.304 1.2,6.48 1.584,8.881 0.241,1.391 0.192,3.072 -1.152,3.072 -1.777,0 -6,-2.833 -8.113,-14.449 -0.145,-0.96 -0.528,-1.536 -1.057,-1.872 -0.719,-0.433 -2.256,-0.817 -5.375,-0.865 0.576,2.928 1.488,8.929 2.16,13.345 0.623,4.032 0.864,6.625 0.719,7.633 0.817,0.288 5.09,1.2 5.568,1.2 C 0.385,6.24 0.48,4.752 0,1.151 -0.047,0.815 -0.096,0.288 -0.145,0 L 0,0 z"
 96 |          id="path3042"
 97 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
 98 |        transform="translate(183.0728,591.7114)"
 99 |        id="g3044"><path
100 |          d="m 0,0 c 2.111,0 6.385,3.937 7.584,10.897 0.049,0.384 0.193,1.104 0.289,1.537 -0.625,0.576 -1.441,0.96 -2.736,0.96 -4.85,0 -7.01,-5.809 -7.01,-9.986 C -1.873,1.152 -1.104,0 -0.049,0 L 0,0 z m -3.168,-4.944 c -3.072,0 -4.992,2.736 -4.992,7.44 0,7.777 4.847,14.93 13.008,14.93 1.441,0 2.736,-0.384 3.552,-0.864 0.432,2.208 1.44,9.025 1.489,11.041 1.343,0.24 4.224,0.671 5.519,0.671 0.53,0 0.674,-0.527 0.481,-1.727 C 14.736,19.346 12.674,5.521 12.289,2.448 12,-0.144 11.953,-2.688 12,-4.128 10.465,-4.8 7.344,-4.944 6.529,-4.944 6.191,-4.944 6,-2.736 6.096,-0.768 6.145,-0.144 6.24,0.769 6.24,0.912 3.84,-3.024 0.527,-4.944 -3.121,-4.944 l -0.047,0 z"
101 |          id="path3046"
102 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
103 |        transform="translate(208.0317,602.2241)"
104 |        id="g3048"><path
105 |          d="M 0,0 C 2.545,5.665 5.568,6.913 7.537,6.913 8.162,6.913 9.121,6.529 9.553,6.049 9.746,4.465 8.498,1.297 7.393,0.097 6.816,0.385 6.098,0.673 5.281,0.673 c -1.633,0 -4.849,-2.545 -6.865,-13.489 -0.145,-0.913 -0.432,-1.297 -0.959,-1.537 -0.816,-0.48 -4.033,-0.864 -5.568,-0.912 0.718,3.937 1.966,11.953 2.447,16.658 0.144,1.2 0.191,3.408 0.096,4.272 0.912,0.432 4.513,1.248 5.328,1.248 0.433,0 0.769,-2.641 0.095,-6.913 L 0,0 z"
106 |          id="path3050"
107 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
108 |        transform="translate(224.9751,591.6636)"
109 |        id="g3052"><path
110 |          d="m 0,0 c 2.354,0 6.625,4.129 7.826,12.001 0.047,0.48 0.096,0.624 0.192,1.104 -0.528,0.192 -1.248,0.336 -1.969,0.336 -1.776,0 -3.6,-0.528 -5.233,-2.736 -1.679,-2.352 -2.4,-5.28 -2.4,-7.633 C -1.584,1.057 -1.008,0 -0.047,0 L 0,0 z m -7.729,2.16 c 0,2.832 0.961,7.777 4.561,11.377 3.072,3.168 6.816,3.937 10.225,3.937 2.256,0 5.328,-0.72 7.25,-1.105 -0.481,-2.112 -1.633,-10.08 -2.161,-14.688 -0.24,-1.969 -0.337,-4.705 -0.24,-5.713 -1.584,-0.672 -4.56,-0.864 -5.377,-0.864 -0.431,0 -0.527,1.968 -0.384,3.84 0.048,0.624 0.144,1.536 0.193,1.92 -1.873,-3.12 -5.568,-5.76 -9.457,-5.76 -2.785,0 -4.61,2.304 -4.61,7.008 l 0,0.048 z"
111 |          id="path3054"
112 |          style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g>
113 | </g><g
114 |      transform="translate(-62.668647,-74.06425)"
115 |      id="layer2"
116 |      style="display:inline"><g
117 |        transform="matrix(1.25,0,0,-1.25,19.117647,990)"
118 |        id="g4555"><g
119 |          id="g2828"><g
120 |            clip-path="url(#clipPath2832)"
121 |            id="g2830"><g
122 |              transform="translate(210.8784,690.4834)"
123 |              id="g2836"><path
124 |                d="m 0,0 c 1.584,-18.452 -27.455,-36.014 -64.859,-39.223 -37.404,-3.209 -69.01,9.151 -70.592,27.602 -1.584,18.455 27.455,36.016 64.859,39.225 C -33.188,30.812 -1.582,18.455 0,0"
125 |                id="path2838"
126 |                style="fill:#bbe6fb;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g><g
127 |          id="g2840"><g
128 |            clip-path="url(#clipPath2844)"
129 |            id="g2842"><g
130 |              id="g2848"><g
131 |                id="g2850" /><g
132 |                id="g2856"><g
133 |                  clip-path="url(#clipPath2852)"
134 |                  id="g2858"
135 |                  style="opacity:0.35000604"><g
136 |                    transform="translate(141.3843,715.9233)"
137 |                    id="g2860"><path
138 |                      d="m 0,0 c -14.268,0.232 -30.964,-5.433 -43.387,-10.738 -1.293,-3.726 -1.989,-7.689 -1.989,-11.797 0,-21.888 19.764,-39.634 44.145,-39.634 24.381,0 44.145,17.746 44.145,39.634 0,6.927 -1.984,13.435 -5.463,19.101 C 27.512,-1.889 13.842,-0.225 0,0"
139 |                      id="path2862"
140 |                      style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g></g></g></g><g
141 |          id="g2864"><g
142 |            clip-path="url(#clipPath2868)"
143 |            id="g2866"><g
144 |              transform="translate(140.1528,715.9277)"
145 |              id="g2872"><path
146 |                d="m 0,0 c -7.899,0.482 -21.514,-3.639 -32.867,-7.75 -1.725,-4.071 -2.683,-8.526 -2.683,-13.201 0,-19.178 17.388,-34.725 35.782,-34.725 18.273,0 34.44,15.572 35.782,34.725 0.436,6.237 -1.711,12.114 -4.692,17.181 C 19.552,-1.697 7.061,-0.431 0,0"
147 |                id="path2874"
148 |                style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g><g
149 |          id="g2876"><g
150 |            clip-path="url(#clipPath2880)"
151 |            id="g2878"><g
152 |              transform="translate(119.8818,697.4946)"
153 |              id="g2884"><path
154 |                d="M 0,0 C 0.969,2.146 2.437,3.197 3.859,4.996 3.701,5.422 3.355,6.815 3.355,7.298 c 0,2.156 1.749,3.906 3.906,3.906 0.509,0 0.995,-0.101 1.44,-0.278 6.465,4.927 14.976,7.075 23.529,5.163 0.781,-0.176 1.547,-0.389 2.299,-0.623 C 26.076,16.638 16.548,13.644 10.067,8.413 10.265,7.946 10.814,6.611 10.814,6.074 10.814,3.917 9.418,3.392 7.261,3.392 6.771,3.392 6.303,3.486 5.87,3.651 4.406,1.685 2.612,-2.06 1.734,-4.401 c 3.584,-3.206 6.822,-4.368 11.042,-5.945 -0.011,0.201 0.145,0.387 0.145,0.592 0,6.503 5.725,11.788 12.229,11.788 5.828,0 10.654,-4.238 11.596,-9.798 2.908,1.85 5.72,3.268 7.863,6.01 -0.5,0.61 -1.039,2.337 -1.039,3.187 0,1.957 1.588,3.544 3.545,3.544 0.277,0 0.543,-0.04 0.802,-0.1 1.088,2.236 1.909,4.606 2.434,7.05 -10.17,7.529 -29.847,6.502 -29.847,6.502 0,0 -15.658,0.817 -26.258,-4.349 C -5.047,8.969 -3.008,4.11 0,0"
155 |                id="path2886"
156 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
157 |              transform="translate(168.4907,700.4282)"
158 |              id="g2888"><path
159 |                d="m 0,0 c 0.719,-0.648 1.111,-1.217 1.42,-1.771 0.951,-1.71 -0.957,-3.275 -2.914,-3.275 -0.199,0 -0.391,0.027 -0.582,0.059 -2.205,-3.446 -6.067,-7.865 -9.498,-10.089 5.261,-0.862 10.222,-2.969 14.17,-6.225 2.875,5.151 5.08,12.589 5.08,18.907 0,4.809 -2.123,8.334 -5.328,10.92 C 2.18,5.95 0.805,2.347 0,0"
160 |                id="path2890"
161 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
162 |              transform="translate(125.7842,667.8032)"
163 |              id="g2892"><path
164 |                d="M 0,0 C 1.753,4.841 6.065,8.592 10.144,11.892 9.547,12.709 8.652,14.732 8.279,15.69 3.304,17.203 -1.098,20.035 -4.512,23.784 -4.537,23.675 -4.568,23.569 -4.594,23.46 -5.237,20.579 -5.355,17.692 -5.035,14.876 -2.653,14.432 -0.85,12.345 -0.85,9.834 -0.85,8.345 -2.155,6.187 -3.168,5.248 -2.067,2.872 -1.316,1.726 0,0"
165 |                id="path2894"
166 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
167 |              transform="translate(125.4756,663.7393)"
168 |              id="g2896"><path
169 |                d="m 0,0 c -2.091,2.079 -3.537,6.226 -4.894,8.83 -0.254,-0.039 -0.514,-0.066 -0.78,-0.066 -2.836,0 -5.807,2.38 -5.135,5.134 0.372,1.524 1.424,2.521 3.137,3.353 -0.39,3.157 -0.496,7.695 0.237,10.977 0.21,0.939 0.655,1.379 0.95,2.273 -3.129,4.579 -5.151,10.589 -5.151,16.552 0,0.218 0.011,0.433 0.016,0.649 -5.288,-2.652 -9.253,-6.83 -9.253,-13.407 0,-14.548 8.379,-28.819 20.846,-34.413 C -0.018,-0.079 -0.01,-0.039 0,0"
170 |                id="path2898"
171 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
172 |              transform="translate(156.1313,683.8511)"
173 |              id="g2900"><path
174 |                d="m 0,0 c -1.611,-4.582 -5.967,-7.873 -11.1,-7.873 -2.746,0 -5.265,0.947 -7.267,2.521 -4.127,-3.214 -7.871,-8.86 -9.774,-13.758 0.854,-0.919 1.449,-1.675 2.407,-2.49 2.887,-0.752 6.863,0 9.988,0 12.57,0 23.703,5.592 30.086,15.398 C 10.096,-3.263 5.09,-0.466 0,0"
175 |                id="path2902"
176 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g><g
177 |          id="g2904"><g
178 |            clip-path="url(#clipPath2908)"
179 |            id="g2906"><g
180 |              transform="translate(119.5596,695.7944)"
181 |              id="g2912"><path
182 |                d="m 0,0 c 0.969,2.146 2.184,4.132 3.605,5.931 -0.158,0.425 -0.25,0.884 -0.25,1.367 0,2.156 1.749,3.906 3.906,3.906 0.509,0 0.995,-0.101 1.44,-0.278 6.465,4.927 14.976,7.075 23.529,5.163 0.781,-0.176 1.547,-0.389 2.299,-0.623 -8.453,1.172 -17.187,-1.419 -23.668,-6.651 0.198,-0.466 0.306,-0.98 0.306,-1.517 0,-2.157 -1.749,-3.906 -3.906,-3.906 -0.49,0 -0.958,0.094 -1.391,0.259 -1.464,-1.966 -2.661,-4.138 -3.539,-6.48 3.078,-3.317 6.856,-5.94 11.075,-7.517 -0.01,0.201 -0.031,0.4 -0.031,0.605 0,6.503 5.271,11.775 11.775,11.775 5.828,0 10.654,-4.238 11.596,-9.798 2.908,1.85 5.492,4.226 7.634,6.968 -0.5,0.61 -0.81,1.379 -0.81,2.229 0,1.957 1.588,3.544 3.545,3.544 0.277,0 0.543,-0.04 0.802,-0.1 1.088,2.236 1.909,4.606 2.434,7.05 -10.17,7.529 -29.847,6.502 -29.847,6.502 0,0 -15.658,0.817 -26.258,-4.349 C -5.047,8.969 -3.008,4.11 0,0"
183 |                id="path2914"
184 |                style="fill:#1287b1;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
185 |              transform="translate(169.0396,699.8481)"
186 |              id="g2916"><path
187 |                d="m 0,0 c 0.719,-0.648 1.18,-1.577 1.18,-2.621 0,-1.957 -1.588,-3.545 -3.545,-3.545 -0.199,0 -0.391,0.027 -0.582,0.059 -2.205,-3.446 -5.127,-6.384 -8.559,-8.608 5.072,-0.793 9.846,-2.945 13.793,-6.201 2.875,5.151 4.518,11.084 4.518,17.402 0,4.809 -2.123,8.334 -5.328,10.92 C 1.309,4.83 0.805,2.347 0,0"
188 |                id="path2918"
189 |                style="fill:#1287b1;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
190 |              transform="translate(126.3252,666.6401)"
191 |              id="g2920"><path
192 |                d="M 0,0 C 1.753,4.841 4.799,9.185 8.878,12.484 8.281,13.302 7.789,14.195 7.416,15.153 2.44,16.666 -1.961,19.498 -5.375,23.247 -5.4,23.138 -5.432,23.032 -5.457,22.923 -6.101,20.042 -6.219,17.155 -5.898,14.339 -3.517,13.895 -1.713,11.808 -1.713,9.297 -1.713,7.808 -2.352,6.469 -3.365,5.53 -2.446,3.582 -1.316,1.726 0,0"
193 |                id="path2922"
194 |                style="fill:#1287b1;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
195 |              transform="translate(125.4619,663.7983)"
196 |              id="g2924"><path
197 |                d="m 0,0 c -2.091,2.079 -3.846,4.467 -5.202,7.07 -0.255,-0.039 -0.515,-0.065 -0.78,-0.065 -2.836,0 -5.135,2.299 -5.135,5.134 0,2.032 1.184,3.784 2.897,4.616 -0.389,3.156 -0.257,6.432 0.477,9.714 0.21,0.938 0.466,1.854 0.761,2.749 -3.129,4.578 -4.962,10.113 -4.962,16.076 0,0.218 0.01,0.433 0.015,0.648 -5.288,-2.651 -9.253,-6.83 -9.253,-13.406 0,-14.549 8.688,-27.06 21.155,-32.654 C -0.018,-0.079 -0.01,-0.039 0,0"
198 |                id="path2926"
199 |                style="fill:#1287b1;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g><g
200 |              transform="translate(155.8091,682.1509)"
201 |              id="g2928"><path
202 |                d="m 0,0 c -1.611,-4.582 -5.967,-7.873 -11.1,-7.873 -2.746,0 -5.265,0.947 -7.267,2.521 -4.127,-3.214 -7.242,-7.595 -9.144,-12.494 0.853,-0.919 1.765,-1.785 2.723,-2.599 2.888,-0.752 5.917,-1.155 9.042,-1.155 12.57,0 23.621,6.49 30.004,16.295 C 10.014,-2.365 5.09,-0.466 0,0"
203 |                id="path2930"
204 |                style="fill:#1287b1;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g><g
205 |          id="g2932"><g
206 |            clip-path="url(#clipPath2936)"
207 |            id="g2934"><g
208 |              id="g2940"><g
209 |                id="g2942" /><g
210 |                id="g2948"><g
211 |                  clip-path="url(#clipPath2944)"
212 |                  id="g2950"><g
213 |                    transform="translate(156.2222,685.187)"
214 |                    id="g2952"><path
215 |                      d="M 0,0 10.879,2.595 -0.041,3.152 8.846,9.944 -1.238,6.329 5.615,15.826 -3.85,9.535 l 3.309,11.117 -6.5,-9.163 -0.148,11.579 -4.277,-10.314 -3.566,10.437 0.193,-12.295 -6.163,11.021 3.335,-11.702 -9.997,7.27 7.831,-9.84 -12.411,4.564 9.795,-7.247 -12.56,-0.386 12.842,-3.314 -12.853,-2.779 12.687,-0.92 -10.699,-6.851 11.017,3.994 -7.644,-9.681 9.659,7.79 -3.478,-12.991 7.457,10.572 -1.045,-12.486 4.233,11.319 3.603,-11.897 0.876,11.933 5.348,-10.181 -3.16,11.645 9.793,-7.586 -6.322,9.672 10.744,-4.186 -8.215,8.073 L 10.85,-4.164 0,0 z"
216 |                      id="path2954"
217 |                      style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g></g></g></g><g
218 |          id="g2956"><g
219 |            clip-path="url(#clipPath2960)"
220 |            id="g2958"><g
221 |              id="g2964"><g
222 |                id="g2966" /><g
223 |                id="g2972"><g
224 |                  clip-path="url(#clipPath2968)"
225 |                  id="g2974"
226 |                  style="opacity:0.35000604"><g
227 |                    transform="translate(40.4033,664.3701)"
228 |                    id="g2976"><path
229 |                      d="m 0,0 c 33.74,33.739 60.687,44.155 85.143,48.91 3.236,0.629 3.848,7.7 3.848,7.7 0,0 0.453,-5.208 2.718,-5.887 2.264,-0.68 5.207,8.152 5.207,8.152 0,0 -2.717,-7.926 0,-8.379 2.718,-0.453 7.699,7.699 7.699,7.699 0,0 -2.037,-7.019 -0.678,-7.472 1.357,-0.453 8.15,10.189 8.15,10.189 0,0 -4.076,-7.019 -0.226,-7.699 3.851,-0.679 9.467,4.791 9.467,4.791 0,0 -4.416,-5.005 -2.448,-5.696 8.379,-2.945 15.159,7.945 15.159,7.945 0,0 -1.571,-4.775 -5.647,-9.983 8.83,-2.264 15.389,11.039 15.389,11.039 l -6.559,-13.303 c 3.397,-1.813 16.985,13.812 16.985,13.812 0,0 -7.02,-12.228 -11.096,-14.718 2.264,-1.812 10.416,5.434 10.416,5.434 0,0 -6.567,-8.151 -4.076,-8.604 3.623,-2.944 16.982,15.171 16.982,15.171 0,0 -5.207,-10.642 -12.906,-19.021 6.435,-3.219 22.418,17.436 22.418,17.436 0,0 -0.453,-6.567 -12.002,-16.983 8.605,1.132 19.701,17.436 19.701,17.436 0,0 -4.076,-12.228 -13.814,-20.832 8.449,0.879 21.964,21.738 21.964,21.738 0,0 -5.207,-14.492 -15.849,-22.871 11.775,-2.604 28.758,14.945 28.758,14.945 0,0 -6.68,-12.455 -15.399,-17.549 9.738,-3.736 23.098,11.662 23.098,11.662 0,0 -13.36,-20.607 -34.645,-19.701 -6.984,0.297 -28.109,21.188 -73.368,19.474 C 44.609,42.57 31.929,17.209 0,0"
230 |                      id="path2978"
231 |                      style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g></g><g
232 |              transform="translate(41.7861,666.9326)"
233 |              id="g2980"><path
234 |                d="m 0,0 c 33.74,33.739 60.686,44.154 85.142,48.91 3.237,0.629 3.849,7.699 3.849,7.699 0,0 0.452,-5.209 2.718,-5.887 2.264,-0.679 5.207,8.151 5.207,8.151 0,0 -2.717,-7.926 0,-8.378 2.718,-0.452 7.699,7.699 7.699,7.699 0,0 -2.037,-7.019 -0.68,-7.472 1.359,-0.453 8.152,10.19 8.152,10.19 0,0 -4.076,-7.02 -0.226,-7.699 3.849,-0.68 9.467,4.79 9.467,4.79 0,0 -4.416,-5.005 -2.448,-5.696 8.379,-2.944 15.157,7.945 15.157,7.945 0,0 -1.571,-4.775 -5.645,-9.983 8.83,-2.265 15.389,11.04 15.389,11.04 l -6.559,-13.305 c 3.397,-1.811 16.983,13.812 16.983,13.812 0,0 -7.018,-12.226 -11.094,-14.717 2.264,-1.812 10.416,5.434 10.416,5.434 0,0 -6.567,-8.152 -4.076,-8.604 3.623,-2.945 16.982,15.171 16.982,15.171 0,0 -5.209,-10.643 -12.906,-19.021 6.435,-3.22 22.418,17.436 22.418,17.436 0,0 -0.453,-6.568 -12.002,-16.984 8.605,1.133 19.701,17.437 19.701,17.437 0,0 -4.076,-12.228 -13.814,-20.833 8.449,0.879 21.964,21.738 21.964,21.738 0,0 -5.207,-14.492 -15.849,-22.87 11.775,-2.604 28.758,14.944 28.758,14.944 0,0 -6.68,-12.453 -15.399,-17.548 9.738,-3.736 23.098,11.662 23.098,11.662 0,0 -13.36,-20.607 -34.647,-19.701 -6.982,0.298 -28.107,21.189 -73.367,19.474 C 44.609,42.57 31.928,17.209 0,0"
235 |                id="path2982"
236 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g><g
237 |          id="g2984"><g
238 |            clip-path="url(#clipPath2988)"
239 |            id="g2986"><g
240 |              id="g2992"><g
241 |                id="g2994" /><g
242 |                id="g3000"><g
243 |                  clip-path="url(#clipPath2996)"
244 |                  id="g3002"
245 |                  style="opacity:0.35000604"><g
246 |                    transform="translate(39.5195,660.6802)"
247 |                    id="g3004"><path
248 |                      d="m 0,0 c 17.832,-8.945 34.137,1.358 54.686,-4.433 15.623,-4.404 34.645,-9.833 60.458,-6.096 25.814,3.735 47.893,14.944 58.424,34.985 3.283,8.943 16.642,-2.039 16.642,-2.039 0,0 -9.736,4.076 -9.509,2.151 0.226,-1.924 14.605,-8.604 14.605,-8.604 0,0 -13.021,4.076 -12.228,1.019 0.793,-3.057 16.302,-15.285 16.302,-15.285 0,0 -17.548,13.36 -19.019,11.549 -1.473,-1.812 7.472,-9.172 7.472,-9.172 0,0 -14.832,9.172 -20.041,6.467 -3.746,-1.943 15.399,-14.506 15.399,-14.506 0,0 -12.455,9.512 -15.399,7.021 -2.943,-2.492 14.04,-22.871 14.04,-22.871 0,0 -19.249,20.833 -21.172,19.814 -1.926,-1.019 5.32,-10.983 5.32,-10.983 0,0 -9.51,10.417 -12.113,8.605 -2.604,-1.812 13.586,-28.871 13.586,-28.871 0,0 -17.549,27.738 -24.795,23.098 11.379,-24.966 7.133,-28.533 7.133,-28.533 0,0 -1.452,25.47 -15.625,24.796 -7.133,-0.34 3.396,-19.021 3.396,-19.021 0,0 -9.691,17.062 -16.145,16.722 11.895,-22.511 7.655,-31.667 7.655,-31.667 0,0 1.967,19.226 -14.166,29.925 6.113,-5.433 -3.836,-29.925 -3.836,-29.925 0,0 8.752,36.091 -6.455,29.21 -2.403,-1.085 -0.17,-18.002 -0.17,-18.002 0,0 -3.057,19.362 -7.641,18.342 -2.673,-0.593 -16.984,-26.833 -16.984,-26.833 0,0 11.719,28.362 8.153,27.173 -2.598,-0.867 -7.473,-12.568 -7.473,-12.568 0,0 2.377,11.549 0,12.228 -2.377,0.68 -15.625,-12.228 -15.625,-12.228 0,0 9.851,11.549 8.152,13.927 -2.574,3.603 -5.591,3.772 -9.171,2.377 -5.209,-2.03 -12.227,-11.548 -12.227,-11.548 0,0 6.996,9.637 5.773,13.247 -1.963,5.8 -22.077,-11.209 -22.077,-11.209 0,0 11.888,11.209 9.171,13.587 -2.717,2.377 -17.471,1.642 -22.078,1.655 C 8.832,-6.454 4.124,-3.267 0,0"
249 |                      id="path3006"
250 |                      style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g></g><g
251 |              transform="translate(38.8408,662.7183)"
252 |              id="g3008"><path
253 |                d="m 0,0 c 17.832,-8.945 34.136,1.358 54.685,-4.434 15.623,-4.402 34.646,-9.832 60.46,-6.095 25.814,3.736 47.891,14.945 58.422,34.984 3.283,8.944 16.642,-2.037 16.642,-2.037 0,0 -9.736,4.075 -9.509,2.15 0.226,-1.924 14.605,-8.604 14.605,-8.604 0,0 -13.021,4.075 -12.228,1.018 0.793,-3.056 16.304,-15.284 16.304,-15.284 0,0 -17.55,13.361 -19.021,11.548 -1.471,-1.811 7.473,-9.17 7.473,-9.17 0,0 -14.833,9.17 -20.041,6.467 -3.747,-1.944 15.398,-14.506 15.398,-14.506 0,0 -12.455,9.511 -15.398,7.02 -2.944,-2.492 14.041,-22.871 14.041,-22.871 0,0 -19.25,20.833 -21.174,19.814 -1.924,-1.02 5.322,-10.982 5.322,-10.982 0,0 -9.512,10.416 -12.115,8.604 -2.604,-1.811 13.586,-28.871 13.586,-28.871 0,0 -17.549,27.739 -24.795,23.097 11.379,-24.965 7.133,-28.532 7.133,-28.532 0,0 -1.452,25.47 -15.625,24.795 -7.133,-0.34 3.396,-19.02 3.396,-19.02 0,0 -9.691,17.063 -16.144,16.723 11.896,-22.512 7.654,-31.668 7.654,-31.668 0,0 1.967,19.227 -14.166,29.926 6.113,-5.434 -3.836,-29.926 -3.836,-29.926 0,0 8.754,36.091 -6.453,29.21 -2.403,-1.086 -0.17,-18.002 -0.17,-18.002 0,0 -3.059,19.361 -7.642,18.342 -2.674,-0.593 -16.985,-26.833 -16.985,-26.833 0,0 11.719,28.362 8.153,27.172 -2.598,-0.865 -7.473,-12.566 -7.473,-12.566 0,0 2.378,11.548 0,12.227 -2.377,0.679 -15.624,-12.227 -15.624,-12.227 0,0 9.851,11.548 8.151,13.926 -2.574,3.603 -5.591,3.771 -9.17,2.376 -5.21,-2.029 -12.228,-11.547 -12.228,-11.547 0,0 6.996,9.638 5.774,13.247 -1.964,5.799 -22.077,-11.209 -22.077,-11.209 0,0 11.888,11.209 9.17,13.586 C 41.778,-5.774 27.024,-6.51 22.417,-6.496 8.831,-6.453 4.124,-3.267 0,0"
254 |                id="path3010"
255 |                style="fill:#373535;fill-opacity:1;fill-rule:nonzero;stroke:none" /></g></g></g></g></g></svg>


--------------------------------------------------------------------------------
/src/img/config.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/HadesArchitect/GrafanaCassandraDatasource/1c1bf128ecdf341a3e067c6c49329d61b5313a41/src/img/config.png


--------------------------------------------------------------------------------
/src/img/configurator.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/HadesArchitect/GrafanaCassandraDatasource/1c1bf128ecdf341a3e067c6c49329d61b5313a41/src/img/configurator.png


--------------------------------------------------------------------------------
/src/img/editor.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/HadesArchitect/GrafanaCassandraDatasource/1c1bf128ecdf341a3e067c6c49329d61b5313a41/src/img/editor.png


--------------------------------------------------------------------------------
/src/img/suggestions.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/HadesArchitect/GrafanaCassandraDatasource/1c1bf128ecdf341a3e067c6c49329d61b5313a41/src/img/suggestions.png


--------------------------------------------------------------------------------
/src/models.ts:
--------------------------------------------------------------------------------
 1 | import { DataQuery } from '@grafana/schema';
 2 | import { DataSourceJsonData } from '@grafana/data';
 3 | 
 4 | export interface CassandraQuery extends DataQuery {
 5 |   target?: string;
 6 |   queryType: CassandraQueryType;
 7 |   filtering?: boolean;
 8 |   keyspace?: string;
 9 |   datasourceId?: number;
10 |   table?: string;
11 |   columnTime?: string;
12 |   columnValue?: string;
13 |   columnId?: string;
14 |   valueId?: string;
15 |   rawQuery?: boolean;
16 |   alias?: string;
17 |   instant?: boolean;
18 | }
19 | 
20 | export interface CassandraVariableQuery {
21 |   query: string;
22 | }
23 | 
24 | export interface CassandraDataSourceOptions extends DataSourceJsonData {
25 |   keyspace: string;
26 |   consistency: string;
27 |   user: string;
28 |   certPath: string;
29 |   rootPath: string;
30 |   caPath: string;
31 |   useCustomTLS: boolean;
32 |   timeout: number;
33 |   allowInsecureTLS: boolean;
34 | }
35 | 
36 | type CassandraQueryType = 'query' | 'alert';
37 | 


--------------------------------------------------------------------------------
/src/module.ts:
--------------------------------------------------------------------------------
 1 | import { DataSourcePlugin } from '@grafana/data';
 2 | import { CassandraDatasource } from './datasource';
 3 | import { CassandraQuery,CassandraDataSourceOptions } from './models';
 4 | import { QueryEditor } from './QueryEditor';
 5 | import { VariableQueryEditor } from './VariableQueryEditor';
 6 | import { ConfigEditor } from './ConfigEditor';
 7 | 
 8 | export const plugin = new DataSourcePlugin<CassandraDatasource, CassandraQuery, CassandraDataSourceOptions>(
 9 |   CassandraDatasource
10 | )
11 |   .setConfigEditor(ConfigEditor)
12 |   .setQueryEditor(QueryEditor)
13 |   .setVariableQueryEditor(VariableQueryEditor); // Deprecated, but there is no documentation on the new approach available atm.
14 | 


--------------------------------------------------------------------------------
/src/plugin.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "Apache Cassandra",
 3 |     "id": "hadesarchitect-cassandra-datasource",
 4 |     "type": "datasource",
 5 |   
 6 |     "backend": true,
 7 |     "alerting": true,
 8 |     "executable": "cassandra-plugin",
 9 |     "metrics": true,
10 |     "annotations": true,
11 |   
12 |     "info": {
13 |       "description": "Apache Cassandra Datasource for Grafana",
14 |       "keywords": ["cassandra", "apache cassandra", "datasource", "dse", "datastax astra", "datastax enterprise"],
15 |       "author": {
16 |         "name": "Aleks Volochnev, Armen Khachkinaev, Vyacheslav Mitrofanov",
17 |         "url": "https://github.com/HadesArchitect/GrafanaCassandraDatasource/blob/main/contributors.md"
18 |       },
19 |       "logos": {
20 |         "small": "img/cassandra.svg",
21 |         "large": "img/cassandra.svg"
22 |       },
23 |       "links": [
24 |         {"name": "GitHub", "url": "https://github.com/HadesArchitect/GrafanaCassandraDatasource"},
25 |         {"name": "MIT License", "url": "https://github.com/HadesArchitect/GrafanaCassandraDatasource/blob/master/LICENSE"}
26 |       ],
27 |       "version": "3.1.1",
28 |       "updated": "2025-05-29",
29 |       "screenshots": [
30 |         {"name": "Query Configurator", "path": "img/configurator.png"},
31 |         {"name": "Query Editor", "path": "img/editor.png"},
32 |         {"name": "Configuration", "path": "img/config.png"},
33 |         {"name": "Suggestions", "path": "img/suggestions.png"}
34 |       ]
35 |     },
36 |     "dependencies": {
37 |       "grafanaDependency": ">=7.4.0",
38 |       "plugins": []
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 |   "extends": "./.config/tsconfig.json"
3 | }


--------------------------------------------------------------------------------