Timestream for InfluxDB インスタンスを作成しこれに接続する

にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/ec2/ で Amazon EC2 コンソールを開きます。

の右上隅で AWS マネジメントコンソール、EC2 インスタンスを作成する AWS リージョンを選択します。

[EC2 ダッシュボード] を選択し、次に [インスタンスを起動] を選択します。

[インスタンスを起動] ページが開いたら、次の設定を選択します。

1. [名前とタグ] で [名前] に ec2-database-connect と入力します。

2. [アプリケーションと OS イメージ (Amazon マシンイメージ)] で [Amazon Linux] を選択し、次に [Amazon Linux 2023 AMI] を選択します。他の選択肢は、デフォルトの選択のままにします。

3. [Instance type] (インスタンスタイプ) で [t2.micro] を選択します。

4. [Key pair (login)] (キーペア (ログイン)) で、[Key pair name] (キーペア名) を選択して、既存のキーペアを使用します。Amazon EC2 インスタンスの新しい key pair を作成するには、[Create new key pair] (新しい key pair を作成する) を選択し、[Create key pair] (キーペアを作成する) ウィンドウを使用して作成します。キーペアの作成については、「Amazon Elastic Compute Cloud ユーザーガイド」の「Amazon EC2 インスタンスのキーペアを作成する」を参照してください。

5. [ネットワーク設定] の [次の SSH トラフィックを許可] で、EC2 インスタンスに接続する SSH の接続元を選択します。表示された IP アドレスが SSH 接続に適している場合は、[My IP] (マイ IP)を選択できます。それ以外の場合は、Secure Shell (SSH) を使用して VPC の EC2 インスタンスへの接続に使用する IP アドレスを決定します。パブリック IP アドレスは、別のブラウザウィンドウまたはタブを開き、checkip.amazonaws.com/ でサービスを使うことで確認できます。IP アドレスの例は 192.0.2.1/32 です。多くの場合、インターネットサービスプロバイダー (ISP) 経由、またはファイアウォールの内側から静的 IP アドレスなしで接続することがあります。その場合、クライアントコンピュータが使用する IP アドレスの範囲を確認してください。

   警告

   SSH アクセスに 0.0.0.0/0 を使用することは推奨されていません。すべての IP アドレスがお使いのパブリック EC2 インスタンスに SSH を使用してアクセスできるようになってしまうためです。この方法は、たとえテスト環境で短い時間であっても許容されません。特定の IP アドレスまたは特定のアドレス範囲にのみ、SSH を使った EC2 インスタンスへのアクセスを承認してください。

にサインイン AWS マネジメントコンソール し、 で Amazon Timestream for InfluxDB コンソールを開きます。 https://console.aws.amazon.com/timestream/

Amazon Timestream for InfluxDB コンソールの右上で、DB インスタンスを作成する AWS リージョンを選択します。

ナビゲーションペインで、[InfluxDB データベース] を選択します。

[InfluxDB データベースを作成] を選択します。

[デプロイ設定] セクションで [リードレプリカを持つクラスター] を選択します。[サブスクリプションのオプションを表示] を選択し、リードレプリカアドオンの購読を開始します。詳細については、「によるリードレプリカライセンス AWS Marketplace」を参照してください。

[データベース認証情報] セクションで、[DB クラスター名] に KronosTest-1 と入力します。

InfluxDB の基本設定パラメータとして、[初期ユーザー名]、[初期組織名]、[初期バケット名]、[パスワード] を入力します。

重要

ユーザーのパスワードを再度表示することはできません。パスワードがないと、インスタンスにアクセスしてオペレータートークンを取得することができなくなります。記録していない場合は、変更する必要がある場合があります。「InfluxDB インスタンスの新しいオペレータートークンの作成」を参照してください。

DB インスタンスが有効になった後にユーザーのパスワードを変更する必要がある場合は、そのように DB インスタンスを変更することができます。DB インスタンスの変更の詳細については、「DB インスタンスの更新」を参照してください。

[インスタンス設定] セクションで、db.influx.large DB インスタンスクラスを選択します。

[ストレージ設定] セクションで、[ストレージタイプ] を [Influx IO 込み (3K)] にします。

[接続設定] セクションで、[ネットワークタイプ] を [IPv4] にします。InfluxDB インスタンスが、新しく作成した EC2 インスタンスと同じサブネットにあることを確認します。[パブリックアクセス] で [パブリックアクセス不可] を選択し、DB インスタンスをプライベートにします。

[フェイルオーバー設定] セクションと [パラメータグループ設定] セクションは、デフォルト値のままにします。

[ログ配信設定] でログインを設定し、タグを作成します (オプション)。ログの詳細については、Timestream InfluxDB インスタンスで InfluxDB ログを表示するための設定 を参照してください。タグの追加に関する詳細については、「リソースへのタグとラベルの追加」を参照してください。

[InfluxDB データベースを作成] を選択します。

[データベース] リストで、新しい InfluxDB インスタンスの名前を選択し、詳細を表示します。DB インスタンスが使用できるようになるまで、DB インスタンスのステータスは [作成中] のままです。

踏み台ホストを作成する: 踏み台ホストを作成するには、新しい EC2 インスタンスを起動するか、既存のインスタンスを使用します。インスタンスに、アクセスしようとしているプライベート Timestream for InfluxDB インスタンスの作成に使用した、セキュリティグループへのアクセスに必要なネットワーク設定があることを確認します。

InfluxDB UI に接続する: 踏み台ホストを作成したら、コンソールに表示されるエンドポイントを使用して InfluxDB UI に接続できます。エンドポイントは <db-identifier>-<*>.timestream-influxdb.<region>.on.aws の形式です。中国では、<db-identifier>-<*>.timestream-influxdb.<region>.on.amazonwebservices.com.rproxy.govskope.ca.cn になります。

ローカル転送用に踏み台ホストを設定する: ローカル転送を設定するには、 AWS Systems Manager (SSM) セッションマネージャーを使用します。次のコマンドを実行し、bastion-ec2-instance-id を踏み台ホストインスタンスの ID、endpoint を上記のコンソールに表示されるエンドポイント、port-number を使用するポート番号にそれぞれ置き換えます。

aws ssm start-session --target bastion-ec2-instance-id \
--document-name AWS-StartPortForwardingSessionToRemoteHost \
--parameters '{"host":["endpoint"], "portNumber":["port-number"], "localPortNumber":["port-number"]}'

ここで SessionManagerPlugin のインストールを求められる場合があります。詳細については、「AWS CLI用の Session Manager プラグインをインストールする」を参照してください。

InfluxDB UI にアクセスする: 上記のステップを完了したら、http://localhost:port-number で InfluxDB UI にアクセスできます。「安全ではない」というメッセージを確認する必要があります。

ドメイン名の検証を有効にする: ドメイン名の検証を有効にするには、/etc/hosts ファイル (Linux)、/private/etc/hosts (Mac)、C:\Windows\System32\drivers\etc (Windows) のいずれかに次の行を追加します。

127.0.0.1    endpoint

これで https://endpoint:port-number から InfluxDB UI にアクセスできます。

InfluxDB UI に接続すると、ログインプロンプトを含む新しいブラウザウィンドウが表示されます。InfluxDB の DB インスタンスの作成に使用した認証情報を入力します。

左側のナビゲーションペインで、矢印アイコンをクリックして [API Tokens] を選択します。

このテストでは、[Generate API Token] を選択します。ドロップダウンリストから [All Access API Token] を選択します。

トークンが画面に表示されます。

「Amazon Elastic Compute Cloud ユーザーガイド」の「SSH を使用した Linux インスタンスへの接続」のステップに従って、先ほど作成した EC2 インスタンスに接続します。

SSH を使用して EC2 インスタンスに接続することをお勧めします。SSH クライアントユーティリティが Windows、Linux、または Mac にインストールされている場合は、次のコマンド形式でインスタンスに接続できます。

ssh -i location_of_pem_file ec2-user@ec2-instance-public-dns-name

例えば、ec2-database-connect-key-pair.pem が Linux の /dir1 に保存されていて、EC2 インスタンスのパブリック IPv4 DNS が ec2-12-345-678-90.compute-1.amazonaws.com であるとします。SSH コマンドは次のようになります。

ssh -i /dir1/ec2-database-connect-key-pair.pem ec2-user@ec2-12-345-678-90.compute-1.amazonaws.com

インスタンスに最新バージョンの Telegraf をインストールしました。これを行うには、次のコマンドを使用します。

cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
EOF

sudo yum install telegraf

Telegraf インスタンスを設定します。

telegraf —section-filter agent:inputs:outputs —input-filter cpu:mem —output-filter timestream config > telegraf.conf

1. 通常 /etc/telegraf にある設定ファイルを編集します。

   sudo nano /etc/telegraf/telegraf.conf

2. CPU、メモリメトリクス、ディスク使用量の入力プラグインを設定します。

   [[inputs.cpu]]
     percpu = true
     totalcpu = true
     collect_cpu_time = false
     report_active = false
   
   [[inputs.mem]]
   
   [[inputs.disk]]
     ignore_fs = ["tmpfs", "devtmpfs", "devfs"]

3. InfluxDB の DB インスタンスにデータを送信し、変更を保存するように出力プラグインを設定します。

   [[outputs.influxdb_v2]]
      urls = ["https://us-west-2-1.aws.cloud2.influxdata.com"]
      token = "<your_telegraf_token"
      organization = "your_org"
      bucket = "your_bucket"
      timeout = "5s"

4. Timestream ターゲットを設定します。

   # Configuration for sending metrics to Amazon Timestream.
   [[outputs.timestream]]
   
     ## Amazon Region and credentials
     region = "us-east-1"
     access_key = "<AWS key here>"
     secret_key = "<AWS secret key here>"
     database_name = "<timestream database name>" # needs to exist
   
     ## Specifies if the plugin should describe on start.
     describe_database_on_start = false
     mapping_mode = "multi-table" # allows multiple tables for each input metrics
   
     create_table_if_not_exists = true
     create_table_magnetic_store_retention_period_in_days = 365
     create_table_memory_store_retention_period_in_hours = 24
   
     use_multi_measure_records = true # Important to use multi-measure records
     measure_name_for_multi_measure_records = "telegraf_measure"
     max_write_go_routines = 25
   

Telegraf サービスを有効にして開始します。

$ sudo systemctl enable telegraf
$ sudo systemctl start telegraf

にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/ec2/ で Amazon EC2 コンソールを開きます。

ナビゲーションペインで、[インスタンス] を選択してください。

EC2 インスタンスの名前の横にあるチェックボックスを選択し、[インスタンスの状態] を選択します。[インスタンスを終了 (削除)] を選択します。

確認を求めるメッセージが表示されたら、[終了 (削除)] を選択してください。

にサインイン AWS マネジメントコンソール し、 で Amazon Timestream for InfluxDB コンソールを開きます。 https://console.aws.amazon.com/timestream/

ナビゲーションペインで、[InfluxDB データベース] を選択します。

削除する DB インスタンスを選択します。[Delete] (削除) をクリックします

削除を確定して [削除] を選択します。