Installing Agent on Cloud Servers

Created:2024-06-13 Last Modified:2024-06-27

This document was translated by ChatGPT

#1. Introduction

DeepFlow supports monitoring cloud servers and automatically injects cloud resource information into all observability data (AutoTagging) by calling cloud vendor APIs.

#2. Deployment Topology

#3. Contact Yunshan Networks to Create a Public Cloud Domain

DeepFlow currently supports resource information synchronization for the following public clouds (marked as TBD are in the process of code organization):

Cloud Provider (English) Cloud Provider (Chinese) Type Identifier Used in DeepFlow
AWS AWS aws
Aliyun 阿里云 aliyun
Baidu Cloud 百度云 baidu_bce
Huawei Cloud 华为云 huawei
Microsoft Azure 微软云 TBD
QingCloud 青云 qingcloud
Tencent Cloud 腾讯云 tencent

#3.1 Obtain the Collector Installation Package and Agent Group ID

When deploying DeepFlow Agent on public cloud servers, you need to obtain the installation package for traditional servers and the Agent Group ID from Yunshan Networks.

#4. Deploy DeepFlow Agent

unzip deepflow-agent-rpm.zip
yum -y localinstall x86_64/deepflow-agent-1.0*.rpm
1
2
unzip deepflow-agent-deb.zip
dpkg -i x86_64/deepflow-agent-1.0*.systemd.deb
1
2
touch /etc/deepflow-agent.yaml

cat << EOF > deepflow-agent-docker-compose.yaml
version: '3.2'
services:
  deepflow-agent:
    image: hub.deepflow.yunshan.net/public/deepflow-agent:v6.4
    container_name: deepflow-agent
    restart: always
    #privileged: true  ## Docker version below 20.10.10 requires the opening of the privileged mode, See https://github.com/moby/moby/pull/42836
    cap_add:
      - SYS_ADMIN
      - SYS_RESOURCE
      - SYS_PTRACE
      - NET_ADMIN
      - NET_RAW
      - IPC_LOCK
      - SYSLOG
    volumes:
      - /etc/deepflow-agent.yaml:/etc/deepflow-agent/deepflow-agent.yaml:ro
      - /sys/kernel/debug:/sys/kernel/debug:ro
      - /var/run/docker.sock:/var/run/docker.sock
    network_mode: "host"
    pid: "host"
EOF

docker compose -f deepflow-agent-docker-compose.yaml up -d
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

Modify the configuration file of deepflow-agent /etc/deepflow-agent.yaml:

controller-ips:
  - 10.1.2.3 # FIXME: DeepFlow Server Node IPs
vtap-group-id-request: 'g-fffffff' # FIXME: agent-group ID
1
2
3

Start deepflow-agent:

systemctl enable deepflow-agent
systemctl restart deepflow-agent
1
2