mirror of
https://github.com/netdata/netdata.git
synced 2025-04-10 16:17:36 +00:00
app to api netdata cloud (#13856)
This commit is contained in:
parent
29271f575a
commit
de96dd73f2
12 changed files with 27 additions and 27 deletions
aclk
claim
daemon
docs/guides/troubleshoot
health/notifications
libnetdata
packaging/installer
tests/alarm_repetition
|
@ -19,7 +19,7 @@ The Cloud App lives at app.netdata.cloud which currently resolves to the followi
|
|||
|
||||
:::caution
|
||||
|
||||
This list of IPs can change without notice, we strongly advise you to whitelist the domain `app.netdata.cloud`, if
|
||||
This list of IPs can change without notice, we strongly advise you to whitelist following domains `api.netdata.cloud`, `mqtt.netdata.cloud`, if
|
||||
this is not an option in your case always verify the current domain resolution (e.g via the `host` command).
|
||||
|
||||
:::
|
||||
|
@ -49,7 +49,7 @@ configuration uses two settings:
|
|||
```conf
|
||||
[global]
|
||||
enabled = yes
|
||||
cloud base url = https://app.netdata.cloud
|
||||
cloud base url = https://api.netdata.cloud
|
||||
```
|
||||
|
||||
If your Agent needs to use a proxy to access the internet, you must [set up a proxy for
|
||||
|
@ -112,7 +112,7 @@ must contain only `EOF`.
|
|||
```bash
|
||||
[global]
|
||||
enabled = no
|
||||
cloud base url = https://app.netdata.cloud
|
||||
cloud base url = https://api.netdata.cloud
|
||||
EOF
|
||||
```
|
||||
|
||||
|
|
|
@ -73,7 +73,7 @@ When coming from [Nodes view page](https://learn.netdata.cloud/docs/cloud/visua
|
|||
If you want to connect a node that is running on a Linux environment, the script that will be provided to you by Netdata Cloud is the [kickstart](/packaging/installer/README.md#automatic-one-line-installation-script) which will install the Netdata Agent on your node, if it isn't already installed, and connect the node to Netdata Cloud. It should be similar to:
|
||||
|
||||
```
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://app.netdata.cloud
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
|
||||
```
|
||||
The script should return `Agent was successfully claimed.`. If the connecting to Netdata Cloud process returns errors, or if you don't see
|
||||
the node in your Space after 60 seconds, see the [troubleshooting information](#troubleshooting).
|
||||
|
@ -101,7 +101,7 @@ The default user is `netdata`. Yours may be different, so pay attention to the o
|
|||
and run the script.
|
||||
|
||||
```bash
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://app.netdata.cloud
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
|
||||
```
|
||||
### Connect an agent running in Docker
|
||||
|
||||
|
@ -212,7 +212,7 @@ docker run -d --name=netdata \
|
|||
--cap-add SYS_PTRACE \
|
||||
--security-opt apparmor=unconfined \
|
||||
-e NETDATA_CLAIM_TOKEN=TOKEN \
|
||||
-e NETDATA_CLAIM_URL="https://app.netdata.cloud" \
|
||||
-e NETDATA_CLAIM_URL="https://api.netdata.cloud" \
|
||||
-e NETDATA_CLAIM_ROOMS=ROOM1,ROOM2 \
|
||||
-e NETDATA_CLAIM_PROXY=PROXY \
|
||||
netdata/netdata
|
||||
|
@ -256,7 +256,7 @@ services:
|
|||
- /etc/os-release:/host/etc/os-release:ro
|
||||
environment:
|
||||
- NETDATA_CLAIM_TOKEN=TOKEN
|
||||
- NETDATA_CLAIM_URL="https://app.netdata.cloud"
|
||||
- NETDATA_CLAIM_URL="https://api.netdata.cloud"
|
||||
- NETDATA_CLAIM_ROOMS=ROOM1,ROOM2
|
||||
|
||||
volumes:
|
||||
|
@ -276,7 +276,7 @@ Connect a _running Netdata Agent container_, where you don't want to recreate th
|
|||
`netdata` with the name of your running container:
|
||||
|
||||
```bash
|
||||
docker exec -it netdata netdata-claim.sh -token=TOKEN -rooms=ROOM1,ROOM2 -url=https://app.netdata.cloud
|
||||
docker exec -it netdata netdata-claim.sh -token=TOKEN -rooms=ROOM1,ROOM2 -url=https://api.netdata.cloud
|
||||
```
|
||||
The values for `ROOM1,ROOM2` can be found by by going to Netdata Cloud, clicking the **Nodes** tab, clicking **Connect Nodes**, selecting **Docker**, and copying the `rooms=` value in the command provided.
|
||||
|
||||
|
@ -288,7 +288,7 @@ you don't see the node in your Space after 60 seconds, see the [troubleshooting
|
|||
To connect a node that is running on a macOS environment the script that will be provided to you by Netdata Cloud is the [kickstart](/packaging/installer/methods/macos.md#install-netdata-with-our-automatic-one-line-installation-script) which will install the Netdata Agent on your node, if it isn't already installed, and connect the node to Netdata Cloud. It should be similar to:
|
||||
|
||||
```bash
|
||||
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install /usr/local/ --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://app.netdata.cloud
|
||||
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install /usr/local/ --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
|
||||
```
|
||||
The script should return `Agent was successfully claimed.`. If the connecting to Netdata Cloud process returns errors, or if you don't see
|
||||
the node in your Space after 60 seconds, see the [troubleshooting information](#troubleshooting).
|
||||
|
@ -328,7 +328,7 @@ You can now move on to connecting. When you connect with the [kickstart](/packag
|
|||
append the same proxy setting you added to `netdata.conf`.
|
||||
|
||||
```bash
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://app.netdata.cloud --claim-proxy http://[user:pass@]host:ip
|
||||
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-kickstart.sh --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud --claim-proxy http://[user:pass@]host:ip
|
||||
```
|
||||
|
||||
Hit **Enter**. The script should return `Agent was successfully claimed.`. If the connecting to Netdata Cloud process returns errors, or if
|
||||
|
@ -511,7 +511,7 @@ using the [ACLK](/aclk/README.md).
|
|||
|
||||
| setting | default | info |
|
||||
|:-------------- |:------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| cloud base url | https://app.netdata.cloud | The URL for the Netdata Cloud web application. You should not change this. If you want to disable Cloud, change the `enabled` setting. |
|
||||
| cloud base url | https://api.netdata.cloud | The URL for the Netdata Cloud web application. You should not change this. If you want to disable Cloud, change the `enabled` setting. |
|
||||
| enabled | yes | The runtime option to disable the [Agent-Cloud link](/aclk/README.md) and prevent your Agent from connecting to Netdata Cloud. |
|
||||
|
||||
### kickstart script
|
||||
|
@ -551,7 +551,7 @@ using `sudo`, or as the user running the Agent (typically `netdata`), and passin
|
|||
-rooms=ROOM1,ROOM2,...
|
||||
where ROOMX is the War Room this node should be added to. This list is optional.
|
||||
-url=URL_BASE
|
||||
where URL_BASE is the Netdata Cloud endpoint base URL. By default, this is https://app.netdata.cloud.
|
||||
where URL_BASE is the Netdata Cloud endpoint base URL. By default, this is https://api.netdata.cloud.
|
||||
-id=AGENT_ID
|
||||
where AGENT_ID is the unique identifier of the Agent. This is the Agent's MACHINE_GUID by default.
|
||||
-hostname=HOSTNAME
|
||||
|
|
|
@ -136,7 +136,7 @@ MACHINE_GUID_FILE="@registrydir_POST@/netdata.public.unique.id"
|
|||
CLAIMING_DIR="${NETDATA_VARLIB_DIR}/cloud.d"
|
||||
TOKEN="unknown"
|
||||
URL_BASE=$(get_config_value cloud global "cloud base url")
|
||||
[ -z "$URL_BASE" ] && URL_BASE="https://app.netdata.cloud" # Cover post-install with --dont-start
|
||||
[ -z "$URL_BASE" ] && URL_BASE="https://api.netdata.cloud" # Cover post-install with --dont-start
|
||||
ID="unknown"
|
||||
ROOMS=""
|
||||
[ -z "$HOSTNAME" ] && HOSTNAME=$(hostname)
|
||||
|
|
|
@ -191,7 +191,7 @@ The command line options of the Netdata 1.10.0 version are the following:
|
|||
-W simple-pattern pattern string
|
||||
Check if string matches pattern and exit.
|
||||
|
||||
-W "claim -token=TOKEN -rooms=ROOM1,ROOM2 url=https://app.netdata.cloud"
|
||||
-W "claim -token=TOKEN -rooms=ROOM1,ROOM2 url=https://api.netdata.cloud"
|
||||
Connect the agent to the workspace rooms pointed to by TOKEN and ROOM*.
|
||||
|
||||
Signals netdata handles:
|
||||
|
|
|
@ -65,7 +65,7 @@ With the introduction of our new architecture, Agents running versions lower tha
|
|||
|
||||
### Verify that your IP is whitelisted from Netdata Cloud
|
||||
|
||||
Most of the nodes change IPs dynamically. It is possible that your current IP has been restricted from accessing `app.netdata.cloud` due to security concerns.
|
||||
Most of the nodes change IPs dynamically. It is possible that your current IP has been restricted from accessing `api.netdata.cloud` due to security concerns.
|
||||
|
||||
To verify this:
|
||||
|
||||
|
@ -75,7 +75,7 @@ To verify this:
|
|||
sudo netdatacli aclk-state | grep "Banned By Cloud"
|
||||
```
|
||||
|
||||
The output will contain a line indicating if the IP is banned from `app.netdata.cloud`:
|
||||
The output will contain a line indicating if the IP is banned from `api.netdata.cloud`:
|
||||
|
||||
```bash
|
||||
Banned By Cloud: yes
|
||||
|
@ -97,13 +97,13 @@ To verify this:
|
|||
2. If you can reach external IPs, then check your domain resolution.
|
||||
|
||||
```bash
|
||||
host app.netdata.cloud
|
||||
host api.netdata.cloud
|
||||
```
|
||||
|
||||
The expected output should be something like this:
|
||||
|
||||
```bash
|
||||
app.netdata.cloud is an alias for main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com.
|
||||
api.netdata.cloud is an alias for main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com.
|
||||
main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com has address 54.198.178.11
|
||||
main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com has address 44.207.131.212
|
||||
main-ingress-545609a41fcaf5d6.elb.us-east-1.amazonaws.com has address 44.196.50.41
|
||||
|
@ -111,7 +111,7 @@ To verify this:
|
|||
|
||||
:::info
|
||||
|
||||
There will be cases in which the firewall restricts network access. In those cases, you need to whitelist the `app.netdata.cloud` domain to be able to see your nodes in Netdata Cloud.
|
||||
There will be cases in which the firewall restricts network access. In those cases, you need to whitelist `api.netdata.cloud` and `mqtt.netdata.cloud` domains to be able to see your nodes in Netdata Cloud.
|
||||
If you can't whitelist domains in your firewall, you can whitelist the IPs that the above command will produce, but keep in mind that they can change without any notice.
|
||||
|
||||
:::
|
||||
|
|
|
@ -199,7 +199,7 @@ fi
|
|||
[ -z "${NETDATA_STOCK_CONFIG_DIR}" ] && NETDATA_STOCK_CONFIG_DIR="@libconfigdir_POST@"
|
||||
[ -z "${NETDATA_CACHE_DIR}" ] && NETDATA_CACHE_DIR="@cachedir_POST@"
|
||||
[ -z "${NETDATA_REGISTRY_URL}" ] && NETDATA_REGISTRY_URL="https://registry.my-netdata.io"
|
||||
[ -z "${NETDATA_REGISTRY_CLOUD_BASE_URL}" ] && NETDATA_REGISTRY_CLOUD_BASE_URL="https://app.netdata.cloud"
|
||||
[ -z "${NETDATA_REGISTRY_CLOUD_BASE_URL}" ] && NETDATA_REGISTRY_CLOUD_BASE_URL="https://api.netdata.cloud"
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# parse command line parameters
|
||||
|
|
|
@ -449,7 +449,7 @@ extern char *netdata_configured_host_prefix;
|
|||
#include "worker_utilization/worker_utilization.h"
|
||||
|
||||
// BEWARE: Outside of the C code this also exists in alarm-notify.sh
|
||||
#define DEFAULT_CLOUD_BASE_URL "https://app.netdata.cloud"
|
||||
#define DEFAULT_CLOUD_BASE_URL "https://api.netdata.cloud"
|
||||
|
||||
#define RRD_STORAGE_TIERS 5
|
||||
|
||||
|
|
|
@ -27,7 +27,7 @@ KICKSTART_SOURCE="$(
|
|||
)"
|
||||
PACKAGES_SCRIPT="https://raw.githubusercontent.com/netdata/netdata/master/packaging/installer/install-required-packages.sh"
|
||||
PATH="${PATH}:/usr/local/bin:/usr/local/sbin"
|
||||
PUBLIC_CLOUD_URL="https://app.netdata.cloud"
|
||||
PUBLIC_CLOUD_URL="https://api.netdata.cloud"
|
||||
REPOCONFIG_URL_PREFIX="https://packagecloud.io/netdata/netdata-repoconfig/packages"
|
||||
REPOCONFIG_VERSION="1-2"
|
||||
START_TIME="$(date +%s)"
|
||||
|
|
|
@ -107,7 +107,7 @@ To automatically claim nodes after installation:
|
|||
- `--claim-rooms`: Specify a comma-separated list of tokens for each War Room this node should appear in.
|
||||
- `--claim-proxy`: Specify a proxy to use when connecting to the cloud in the form of `http://[user:pass@]host:ip` for an HTTP(S) proxy.
|
||||
See [connecting through a proxy](/claim/README.md#connect-through-a-proxy) for details.
|
||||
- `--claim-url`: Specify a URL to use when connecting to the cloud. Defaults to `https://app.netdata.cloud`.
|
||||
- `--claim-url`: Specify a URL to use when connecting to the cloud. Defaults to `https://api.netdata.cloud`.
|
||||
|
||||
For example:
|
||||
|
||||
|
|
|
@ -44,11 +44,11 @@ area](https://learn.netdata.cloud/docs/cloud/spaces#manage-spaces).
|
|||
- `--claim-rooms`: Specify a comma-separated list of tokens for each War Room this node should appear in.
|
||||
- `--claim-proxy`: Specify a proxy to use when connecting to the cloud in the form of `http://[user:pass@]host:ip` for an HTTP(S) proxy.
|
||||
See [connecting through a proxy](/claim/README.md#connect-through-a-proxy) for details.
|
||||
- `--claim-url`: Specify a URL to use when connecting to the cloud. Defaults to `https://app.netdata.cloud`.
|
||||
- `--claim-url`: Specify a URL to use when connecting to the cloud. Defaults to `https://api.netdata.cloud`.
|
||||
|
||||
For example:
|
||||
```bash
|
||||
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install /usr/local/ --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://app.netdata.cloud
|
||||
curl https://my-netdata.io/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --install /usr/local/ --claim-token TOKEN --claim-rooms ROOM1,ROOM2 --claim-url https://api.netdata.cloud
|
||||
```
|
||||
The Netdata Agent is installed under `/usr/local/netdata` on your machine. Your machine will also show up as a node in your Netdata Cloud.
|
||||
|
||||
|
|
|
@ -52,4 +52,4 @@
|
|||
allow from = *
|
||||
|
||||
[cloud]
|
||||
cloud base url = https://app.netdata.cloud
|
||||
cloud base url = https://api.netdata.cloud
|
||||
|
|
|
@ -52,4 +52,4 @@
|
|||
allow from = *
|
||||
|
||||
[cloud]
|
||||
cloud base url = https://app.netdata.cloud
|
||||
cloud base url = https://api.netdata.cloud
|
||||
|
|
Loading…
Add table
Reference in a new issue