安装自托管经典版 ( Docker )

映像命令

安装程序随附了一组用于管理 Instana Docker 映像的命令。

instana images export -k ${agent_key}

instana images import -f /path/to/export.tar

instana images pull -k ${agent_key}

instana images push -u ${registry_user} -p ${registry_pass} -r ${registry_url}

instana images version

instana images prune

安装 Instana 软件包

要在计算机上安装 Instana 软件包，请使用以下安装步骤：

export DOWNLOAD_KEY=<download_key>

echo 'deb [signed-by=/usr/share/keyrings/instana-archive-keyring.gpg] https://artifact-public.instana.io/artifactory/rel-debian-public-virtual generic main' > /etc/apt/sources.list.d/instana-product.list

cat << EOF > /etc/apt/auth.conf
machine artifact-public.instana.io
  login _
  password $DOWNLOAD_KEY
EOF

wget -nv -O- --user=_ --password="$DOWNLOAD_KEY" https://artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-debian-public-virtual | gpg --dearmor > /usr/share/keyrings/instana-archive-keyring.gpg

apt update -y

apt install -y instana-console

cat > /etc/apt/preferences.d/instana-console <<EOF
Package: instana-console
Pin: version <version to pin>
Pin-Priority: 1000
EOF

export DOWNLOAD_KEY=<download_key>

cat << EOF > /etc/yum.repos.d/Instana-Product.repo
[instana-product]
name=Instana-Product
baseurl=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/rel-rpm-public-virtual/
enabled=1
gpgcheck=0
gpgkey=https://_:$DOWNLOAD_KEY@artifact-public.instana.io/artifactory/api/security/keypair/public/repositories/rel-rpm-public-virtual
repo_gpgcheck=1
EOF

yum clean expire-cache -y

yum update -y

yum install -y instana-console

yum install python3-dnf-plugin-versionlock

yum versionlock add instana-console

安装 Instana 后台

重要提示： Instana 命令需要 root 用户才能运行，因为它需要调整内核中的某些值，并确保不同挂载点的访问权限设置正确。 Instana 容器实现为无根容器。 因此，即使 root 用户对于安装程序是必需的，应用程序本身也会在提供的实例用户中运行。

1. 运行以下命令，在计算机上安装 Instana 后端：

   instana init
   

   A settings.hcl 文件会在运行 instana init 命令的同一目录下生成。

2. 选择 single（单主机安装）。

3. 输入以下信息：

   • 租户名称和单元名称。

     • 租户名称必须与正则表达式模式 ^[a-z][a-z0-9]*$ 匹配。
     • 租户名称的最大长度不得超过 15 个字符。
     • 租户姓名必须以字母开头。
     • 租户名称可以由字母数字字符组成。
     • 字符必须小写。

   • 代理程序密钥和销售密钥。

   • DNS 名称。

   • 证书文件的路径。 如果未定义任何路径，那么 Instana 将为 cert 文件夹中的 UI (tls.crt) 和密钥 (tls.key) 生成 HTTPS TLS 证书。 要生成自己的自签名证书，请运行以下命令，并将 <hostname> 替换为要安装 Instana 后端的主机名称：

     openssl req -x509 -newkey rsa:2048 -keyout tls.key -out tls.crt -days 365 -nodes -subj "/CN=<hostname>"
     

4. 使用显示的凭证登录 Instana 用户界面。

5. 部署 Instana 后，激活许可证。

可选：从现有机器复制数据

要从当前安装迁移，需要将现有数据迁移到新机器上。

为此，最好从原始安装中复制现有的数据和日志目录。 您可以查看 settings.hcl 原始文件，查找这些目录的挂载位置。

Instana 关闭后，可以从这些目录中复制：

• 所有以 clickhouse 命名的目录，如 /mnt/traces/clickhouse 和 /mnt/log/instana/clickhouse。
• 所有以 zookeeper 命名的目录，如 /mnt/data/zookeeper 和 /mnt/log/instana/zookeeper。

将目录移至新机器上的相同目录，并配置新的 settings.hcl 文件。

不要求您删除旧目录，但建议您在新设置启动并运行后再删除。

安装 instana-console

如前所述，从软件源安装 instana-console 。

公开 Docker 守护进程端口

计算实例的安装程序将尝试连接到该主机的端口 :2376 以检查先决条件。 您需要公开 Docker Daemon 端口。

如果设置不当，您会看到以下错误信息：

remote docker daemon is not reachable on host <clickhouse-host>:2376 : Cannot connect to the Docker daemon at tcp://<clickhouse-host>:2376. Is the docker daemon running?

要在远程 ClickHouse 主机上启用 Docker 引擎 api，请按照以下说明操作：

• 在终端中导航至 /lib/systemd/system 并打开 docker.service 文件 vim /lib/systemd/system/docker.service
• 找到以 ExecStart 开头的一行，并添加 -H=tcp://0.0.0.0:2376 ，使其看起来像 ExecStart=/usr/bin/dockerd -H=fd:// -H=tcp://0.0.0.0:2376
• 保存修改后的文件
• 重新加载 docker 守护进程 systemctl daemon-reload
• 重启容器 sudo service docker restart

在第一台主机上安装 ClickHouse 和 Zookeeper

  type = "dual-clickhouse"

instana init -y

iptables -A INPUT -s $(instana backend host IP) -j ACCEPT
iptables -A OUTPUT -d $(instana backend host IP) -j ACCEPT
iptables -A INPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A OUTPUT -d $(ssh host IP) -j ACCEPT #optional
iptables -A INPUT -j REJECT
iptables -A OUTPUT -j REJECT

在第二台主机上安装 Instana 的其余部分

  type                    = "dual-instana"
  clickhouse_bind_address = <IP of ClickHouse box>

  instana init -y

监控自我托管的 Instana 后台

建议您在 INFRASTRUCTURE 模式下安装 Instana 主机代理，以监控自托管 Instana 后端的健康状况。 然后，就可以为 Instana 后台收集一系列健康检查和指标。

基础设施模式至关重要。 APM 模式会给自托管的后端服务带来不必要的负载。 更多信息，请参阅主机代理模式。

有关安装主机代理的更多信息，请参阅安装主机代理。

启用可选功能

自托管后端默认不启用某些功能。 您可以使用其他配置选项启用这些功能。

有关可选功能以及如何启用这些功能的更多信息，请参阅启用可选功能。

指定私人 Docker 注册表

要指定私有 Docker 注册表作为以后后端迁移或升级的注册表，请运行以下命令：

• 单主机安装：

  instana containerize --type single -y --registryUrl {url} --registryUser {user} --registryPass {pass}
  

• 双主机安装：

  instana containerize --type dual-clickhouse -y --registryUrl {url} --registryUser {user} --registryPass {pass}
  

  instana containerize --type dual-instana -y --registryUrl {url} --registryUser {user} --registryPass {pass}