Dockerベースのデータ・ストアのセットアップ

小規模から中規模のインストールの場合は、 instana-consoleを使用してデータベース・ホストをセットアップできます。 必要なすべてのデータ・ストア・インスタンスは、単一のホスト上で Docker イメージとして実行されます。

前提条件

Docker ベースのデータストアを設定するための前提条件は、セルフホスト型 Classic Edition の 「前提条件 」セクション( Docker )に記載されているものと同じです。

最小要件

Dockerベースのデータ・ストアをインストールするマシンには、少なくとも 12 個の CPU と 10 GB の使用可能メモリーが必要です。 これは最小限度であり、小規模インストールの場合にのみ推奨されます。

Instana パッケージのインストール

お使いのマシンに Instana パッケージをインストールするには、以下の手順に従ってください:

Ubuntu/Debian

root として、以下のコマンドを実行してリポジトリーを追加します。 <download_key> はダウンロード・キーに置き換えてください。

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
 

instana-consoleのインストール:

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
 

Red Hat/CentOS

root として、以下のコマンドを実行してリポジトリーを追加します。 <download_key> はダウンロード・キーに置き換えてください。

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
 

instana-consoleのインストール:

yum clean expire-cache -y
yum update -y
yum install -y instana-console
 

versionlockプラグインがホストにインストールされていない場合は、以下のコマンドを実行してプラグインをインストールしてください。

yum install python3-dnf-plugin-versionlock
 

自動更新中に主要な更新が取得されないようにするには、以下のコマンドを実行します。

yum versionlock add instana-console
 

db-settings.hcl の設定

db-settings.hcl ファイルは、セットアップ・プロセスの構成ファイルです。

注: パフォーマンス上の理由から、すべてのディレクトリーは別々のディスク上に配置する必要があります。
type      = "single-db"
host_name = "<IP-accessible-from-the-k8s-cluster>"

dir {
  metrics    = "/mnt/metrics"  // data dir for metrics
  traces     = "/mnt/traces"   // data dir for traces
  data       = "/mnt/data"    // data dir for any other data
  logs       = "/var/log/instana" // log dir
}

docker_repository {
  base_url = "artifact-public.instana.io"
  username = "_"
  password = "<Your-agent-key>"
}
 

DB 資格情報などの欠落値が生成され、 settings.hcl ファイルに自動的に追加されます。

instana-console のコマンド

ホストの初期セットアップの場合は、以下のコマンドを実行します。

instana datastores init -f /path/to/db-settings.hcl
 

すべてのデータベース・コンテナーを停止するには、次のコマンドを実行します。

instana datastores stop
 

すべてのデータベース・コンテナーを開始するには、以下のコマンドを実行します。

instana datastores start
 

イメージを、現在インストールされている instana-consoleのバージョンによって決定されるバージョンに更新するには、次のコマンドを実行します。

instana datastores update -f /path/to/db-settings.hcl
 

既存のインストール済み環境の完全な settings.hcl ファイルを生成するには、以下のコマンドを実行します。

instana datastores settings