Ilya Mashchenko 6dd26c2789 docs: fix win deploy command for nightly (#19236) 1 day ago
..
cloud-authentication 50078b96f8 Regenerate integrations docs (#19164) 1 week ago
cloud-notifications 4a2c59f2bb Regenerate integrations.js (#18771) 2 months ago
logs decaca50f4 Regenerate integrations.js (#18834) 1 month ago
schemas dfcf47e4cc Ιmplementation to add logs integrations (#18791) 2 months ago
templates dfcf47e4cc Ιmplementation to add logs integrations (#18791) 2 months ago
README.md 32a6cd38e7 Capitalize the word "Agent" (#19044) 3 weeks ago
categories.yaml d9c5f20458 add Okta SSO integration (#17351) 8 months ago
check_collector_metadata.py e848a47675 update integrations gen script (#19085) 3 weeks ago
deploy.yaml 6dd26c2789 docs: fix win deploy command for nightly (#19236) 1 day ago
gen_doc_collector_page.py e848a47675 update integrations gen script (#19085) 3 weeks ago
gen_docs_integrations.py e848a47675 update integrations gen script (#19085) 3 weeks ago
gen_integrations.py e848a47675 update integrations gen script (#19085) 3 weeks ago
pip.sh 8fa34d8c25 Move dependency handling for integrations to script. (#19185) 6 days 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.