| 1 | # .env.template -- copy to .env and fill in. |
| 2 | # |
| 3 | # .env is gitignored; .env.template is committed. |
| 4 | # See <repo>/.agents/ENV.md for the full setup guide |
| 5 | # (where each value comes from, sample formats, common |
| 6 | # mistakes). |
| 7 | # |
| 8 | # Only fill in the keys you need. Each skill checks the |
| 9 | # specific keys it requires and exits with a clear message |
| 10 | # if any are missing. |
| 11 | |
| 12 | # --------------------------------------------------------------- |
| 13 | # Netdata Cloud REST API |
| 14 | # --------------------------------------------------------------- |
| 15 | # Used by: query-netdata-cloud, query-netdata-agents, |
| 16 | # query-agent-events. |
| 17 | # |
| 18 | # NETDATA_CLOUD_TOKEN -- long-lived Cloud REST token. |
| 19 | # Get one at: https://app.netdata.cloud |
| 20 | # -> top-right user menu -> Settings -> API Tokens |
| 21 | # -> "Create API Token" with `scope:all` (or at least |
| 22 | # scope:grafana-plugin for read-only queries). |
| 23 | # Sample format: 36-char UUID-shaped token. |
| 24 | NETDATA_CLOUD_TOKEN="" |
| 25 | |
| 26 | # NETDATA_CLOUD_HOSTNAME -- Cloud REST API host. |
| 27 | # Almost always app.netdata.cloud. |
| 28 | NETDATA_CLOUD_HOSTNAME="app.netdata.cloud" |
| 29 | |
| 30 | # --------------------------------------------------------------- |
| 31 | # Cross-org repo mirror |
| 32 | # --------------------------------------------------------------- |
| 33 | # Used by: mirror-netdata-repos (the sync script + path refs in |
| 34 | # integrations-lifecycle, learn-site-structure, etc.). |
| 35 | # |
| 36 | # NETDATA_REPOS_DIR -- absolute path to the directory holding |
| 37 | # your local Netdata-org repos mirror. Will be created if you |
| 38 | # run sync-netdata-repos.sh on an empty parent. |
| 39 | # |
| 40 | # Sample: "$HOME/src/netdata" |
| 41 | NETDATA_REPOS_DIR="" |
| 42 | |
| 43 | # --------------------------------------------------------------- |
| 44 | # agent-events ingestion node (for query-agent-events skill) |
| 45 | # --------------------------------------------------------------- |
| 46 | # Used by: query-agent-events (and by query-netdata-agents |
| 47 | # as the canonical example for direct-agent calls). |
| 48 | # |
| 49 | # AGENT_EVENTS_HOSTNAME -- network address of the ingestion node. |
| 50 | # Dual-duty: ssh host AND direct-HTTP host (port 19999). Can be |
| 51 | # a DNS name or an IP literal. |
| 52 | # |
| 53 | # NOTE: this is NOT the journalctl namespace (hardcoded to |
| 54 | # 'agent-events' on the ingestion server) and NOT the Cloud |
| 55 | # room name (also hardcoded to 'agent-events'). |
| 56 | # |
| 57 | # Sample: "10.20.1.105" or "agent-events.example.org" |
| 58 | AGENT_EVENTS_HOSTNAME="" |
| 59 | |
| 60 | # AGENT_EVENTS_NODE_ID -- the Cloud node UUID for the |
| 61 | # agent-events node. Find it by visiting the node in |
| 62 | # app.netdata.cloud and copying the UUID from the URL, or |
| 63 | # by listing nodes via the Cloud API. |
| 64 | AGENT_EVENTS_NODE_ID="" |
| 65 | |
| 66 | # AGENT_EVENTS_MACHINE_GUID -- the Netdata machine GUID for |
| 67 | # the agent-events node. Find it on the host with: |
| 68 | # sudo cat /var/lib/netdata/registry/netdata.public.unique.id |
| 69 | AGENT_EVENTS_MACHINE_GUID="" |
| 70 | |
| 71 | # --------------------------------------------------------------- |
| 72 | # Coverity Scan triage (for coverity-audit skill) |
| 73 | # --------------------------------------------------------------- |
| 74 | # Used by: coverity-audit. All four required. |
| 75 | # |
| 76 | # COVERITY_HOST -- the Coverity Scan host. For Netdata, this |
| 77 | # is scan4.scan.coverity.com (newer instance). |
| 78 | COVERITY_HOST="https://scan4.scan.coverity.com" |
| 79 | |
| 80 | # COVERITY_PROJECT_ID -- the integer project id. |
| 81 | # Find it in the URL when you click your project in the |
| 82 | # Coverity Scan dashboard, e.g. ?projectId=12345 |
| 83 | COVERITY_PROJECT_ID="" |
| 84 | |
| 85 | # COVERITY_COOKIE -- the full Cookie header captured from a |
| 86 | # logged-in browser session. Open DevTools (F12) -> Network |
| 87 | # -> click any request to scan4.scan.coverity.com -> Headers |
| 88 | # -> Request Headers -> copy the entire Cookie value |
| 89 | # (including XSRF-TOKEN=...). Refresh roughly every 12-24h |
| 90 | # when keepalive.sh isn't running. |
| 91 | COVERITY_COOKIE="" |
| 92 | |
| 93 | # COVERITY_VIEW_OUTSTANDING -- the integer viewId for your |
| 94 | # "Outstanding defects" view. Find it in the URL when you |
| 95 | # open that view, e.g. ?viewId=10001 |
| 96 | COVERITY_VIEW_OUTSTANDING="" |
| 97 | |
| 98 | # --------------------------------------------------------------- |
| 99 | # SonarCloud triage (for sonarqube-audit skill) |
| 100 | # --------------------------------------------------------------- |
| 101 | # Used by: sonarqube-audit. All four required. |
| 102 | # |
| 103 | # SONAR_HOST_URL -- the SonarCloud host. |
| 104 | SONAR_HOST_URL="https://sonarcloud.io" |
| 105 | |
| 106 | # SONAR_ORG -- your sonarcloud.io organization key. |
| 107 | SONAR_ORG="" |
| 108 | |
| 109 | # SONAR_PROJECT -- the projectKey of your project on SonarCloud. |
| 110 | # For Netdata: netdata_netdata |
| 111 | SONAR_PROJECT="netdata_netdata" |
| 112 | |
| 113 | # SONAR_TOKEN -- a personal access token. |
| 114 | # Generate at: https://sonarcloud.io/account/security |
| 115 | SONAR_TOKEN="" |
| 116 | |
| 117 | # --------------------------------------------------------------- |
| 118 | # Codacy Cloud (for codacy-audit skill) |
| 119 | # --------------------------------------------------------------- |
| 120 | # Used by: codacy-audit (pr-issues.sh and any v3 API wrapper). |
| 121 | # analyze-local.sh runs the CLI anonymously and does NOT need |
| 122 | # CODACY_TOKEN. |
| 123 | # |
| 124 | # CODACY_TOKEN -- Account API token. Header form is |
| 125 | # `api-token: <value>` (NOT Bearer). |
| 126 | # Get one at: https://app.codacy.com |
| 127 | # -> top-right avatar -> Account -> API tokens |
| 128 | # -> "Create API Token" |
| 129 | CODACY_TOKEN="" |
| 130 | |
| 131 | # CODACY_HOST / CODACY_PROVIDER / CODACY_ORG / CODACY_REPO are |
| 132 | # all optional and default to api.codacy.com / gh / netdata / |
| 133 | # netdata. Override only if you point this skill at a different |
| 134 | # Codacy org or repo. |
| 135 | # CODACY_HOST="https://api.codacy.com" |
| 136 | # CODACY_PROVIDER="gh" |
| 137 | # CODACY_ORG="netdata" |
| 138 | # CODACY_REPO="netdata" |