Netdata bot bd52c08091 Regenerate integrations.js (#16200) 1 year ago
..
cloud-notifications 983e70f1f6 Regenerate integrations.js (#16176) 1 year ago
schemas f1a28f5137 Fix handling of troubleshooting section in integrations. (#15700) 1 year ago
templates ff3cbef2b5 Bugfix in integrations/setup/template (#16142) 1 year ago
README.md 183bb1db19 Add initial tooling for generating integrations.js file. (#15406) 1 year ago
categories.yaml 6ad1828b65 Update categories.yaml (#16097) 1 year ago
check_collector_metadata.py 183bb1db19 Add initial tooling for generating integrations.js file. (#15406) 1 year ago
deploy.yaml b276655f1c Change the build image of EL packages from alma to rocky (#15944) 1 year ago
gen_doc_collector_page.py 5ff2ec1a29 Make collectors/COLLECTORS.md have its list autogenerated from integrations.js (#15995) 1 year ago
gen_docs_integrations.py 141647b291 Add icons to integrations markdown files (#16169) 1 year ago
gen_integrations.py 112275c789 Fixes in integration generation script (#16141) 1 year ago
integrations.js bd52c08091 Regenerate integrations.js (#16200) 1 year ago

README.md

To generate a copy of integrations.js locally, you will need:

  • Python 3.6 or newer (only tested on Python 3.10 currently, should work on any version of Python newer than 3.6).
  • The following third-party Python modules:
    • jsonschema
    • referencing
    • jinja2
    • ruamel.yaml
  • A local checkout of https://github.com/netdata/netdata
  • A local checkout of https://github.com/netdata/go.d.plugin. The script expects this to be checked out in a directory called go.d.plugin in the root directory of the agent repo, though a symlink with that name pointing at the actual location of the repo will work as well.

The first two parts can be easily covered in a Linux environment, such as a VM or Docker container:

  • On Debian or Ubuntu: apt-get install python3-jsonschema python3-referencing python3-jinja2 python3-ruamel.yaml
  • On Alpine: apk add py3-jsonschema py3-referencing py3-jinja2 py3-ruamel.yaml
  • On Fedora or RHEL (EPEL is required on RHEL systems): dnf install python3-jsonschema python3-referencing python3-jinja2 python3-ruamel-yaml

Once the environment is set up, simply run integrations/gen_integrations.py from the agent repo. Note that the script must be run from this specific location, as it uses it’s own path to figure out where all the files it needs are.