以下のコンテンツはシャン シリコン バレーからのものです。このシリーズの記事は主に私自身が後で閲覧しやすくするために書きました。PDF を持ち歩く必要がなく、探すのが面倒です。
第15章 InfluxDBサービスプロセスパラメータ(influxdコマンドの使用)
15.1 influxdコマンドリスト
1. InfluxDB がダウンロードされた後、解凍されたディレクトリ内の influxd が InfluxDB サービス プロセスの起動コマンドになります。この記事では influxd のすべてのコマンドを紹介するわけではありませんが、次のコマンド リストを通じて、InfluxDB の構成可能な機能の一部を垣間見ることができます。詳細については、https://docs.influxdata.com/influxdb/v2.4/reference/cli/influx/を参照してください。
注文 | 直訳 | 説明する |
---|---|---|
ダウングレード | ダウングレード | メタデータ形式をダウングレードして古いリリースに一致させる |
ヘルプ | ヘルプ | influxd コマンドのヘルプ情報を出力します。 |
検査する | 診る | ディスク上のデータベースのデータを確認します |
印刷設定 | 印刷設定 | (このコマンドは 2.4 で非推奨になりました) 現在の環境の完全な influxd 構成情報を出力します |
息 | ||
回復 | 回復する | InfluxDB への操作権限を復元し、トークン、組織、ユーザーを管理します |
走る | 走る | influxd サービスを実行します (デフォルト) |
アップグレード | アップグレード | InfluxDB を 1.x から InfluxDB2.4 にアップグレードする |
バージョン | バージョン | InfluxDB の現在のバージョンを出力します。 |
2. InfluxDB の現在の構成を表示するために influxd コマンドを使用する必要はありません。 influx-cli コマンドを使用することもできます。
influx server-config
15.2 influxd の 2 つの重要なコマンド
1. 運用環境で使用される可能性が最も高い 2 つのコマンドは、inspect と Recovery です。以下では、これら 2 つのコマンドについて詳しく説明します。
15.2.1 検査コマンド
1. 次のコマンドを使用して、inspect サブコマンドのヘルプ情報を表示できます。
./influxd inspect -h
2. Inspection サブコマンドの下に多くのサブコマンドがあることがわかります。ここに表示される tsi、tsm、および wal はすべて、InfluxDB の基盤となるストレージ エンジンに関連していますが、この記事ではこの部分については説明しません。ここを少しクリックすると、次のコマンドを使用して、InfluxDB のデータ ストレージの一般的な状況を表示できます。
./influd inspect report-tsm
3. 実行結果は下図のようになります。表示される情報には、InfluxDB 全体にシーケンスが何個あるか、各バケットにシーケンスが何個あるかなど、InfluxDB のデータ格納状況が含まれます。
4. さらに、より重要なexport-tsmコマンドがあります。これは、特定のバケット内のすべてのデータをInfluxDB行プロトコルにエクスポートできます。その使用方法については、後の例で詳しく説明します。
15.2.2 リカバリコマンド
1.リカバリーとは回復を意味します。まず、次のコマンドを使用して、recovery サブコマンドのヘルプ情報を表示します。
./influd recovery -h
2. 図に示すように、influxd 回復コマンドは主に、InfluxDB の操作に必要なオペレーター権限を修復または再生成するために使用されます。
3. リカバリ中の 3 つのサブコマンド、つまり auth、org、および user があります。これらはそれぞれトークン、組織、ユーザーに関連しています。ここでは、auth サブコマンドの使用方法を中心に説明しますが、auth サブコマンドのヘルプ情報をさらに参照するには、次のコマンドを使用します。
./influxd recovery auth -h
4. 返される結果は次のとおりです。
5. 2 つのサブコマンドがあることがわかります。
- create-operator: ユーザーの新しいオペレーター トークンを作成します。
- list: 現在のデータベース内のすべてのトークンをリストします。
6. 次のコマンドを使用して、ユーザー tony のオペレータートークンを再度作成します。
.atguigu/influxd recovery auth create - operator --username tony --org
7. コマンド実行後、ターミナルには下図のような内容が表示され、tony’sRecovery Token というオペレータートークンが作成されていることがわかります。
15.3 Influxd の共通設定項目
1. influxd で使用できる構成項目は非常に多数あるため、この記事ではすべてを説明することはできません。詳細については、https://docs.influxdata.com/influxdb/v2.4/reference/config-options/#assets-path を参照してください。
2. 以下は一般的に使用されるパラメータです。
- ボルトパス:BoltDB ファイルのパス。
- Engine-path: InfluxDB ファイルへのパス
- sqlit-path: sqlite のパス InfluxDB はタスクの実行に関するメタデータを保存する sqllite も使用します。
- flux-log-enabled: ログを有効にするかどうか。デフォルトは false です。
- og-level: ログ レベル。デバッグ、情報、エラーなどをサポートします。デフォルトは情報です。
15.4 influxdの構成方法
1. influxd を設定するには 3 つの方法があります。ここでは http-bind-address を使用して操作を実行し、全員にそれをデモンストレーションします。
15.4.1 コマンドラインパラメータ
1. 次の操作を実行する前に、現在実行中の influxd を必ず閉じてください。もちろん、次のコマンドを使用して influxd プロセスを強制終了することもできます。そうでない場合、元の influxd プロセスがBoltDB データベースをロックし、他のプロセスがそれにアクセスできなくなります。もちろんBlotDBのパスを変更することもできますが、それは面倒です。
ps -ef | grep influxd | grep -v grep | awk '{print $2}' | xargs kill
2. ユーザーが influxd コマンドを使用して InfluxDB を開始すると、構成項目がコマンド ライン パラメータを通じて渡されます。例えば:
./influxd --http-bind-address=:8088
3. ポート 8088 にアクセスして、サービスがポートに接続されているかどうかを確認します。
15.4.2 環境変数
1. 同様に、最初に前の influxd プロセスを強制終了します。次のコマンドを実行します。
ps -ef | grep influxd | grep -v grep | awk '{print $2}' | xargs kill
2. ユーザーは環境変数を宣言して influxd を設定できます例: それでは、influxd を起動して効果を確認してみましょう。
export INFLUXD_HTTP_BIND_ADDRESS=:8089
3. 最後に、export コマンドを使用しているため、一時的に環境変数を設定しますが、現在のシェル セッションが重要でないと思われる場合は、現在のシェル セッションを閉じてかまいません。それ以外の場合は、unset コマンドを使用してこの環境変数を破棄できます。
unset INFLUXD_HTTP_BIND_ADDRESS
15.4.3 設定ファイル
1. また、nfluxd が配置されているディレクトリに構成ファイル (config.json、config.toml、または config.yaml) を配置します。 Influxd はこれら 3 つの形式を認識できますが、ファイル内のコンテンツは合法である必要があります。 Influxd は、起動時にこのファイルを自動的に検出します。
2. InfluxDB インストール ディレクトリに config.json ファイルを作成します。
vim /opt/module/influxdb2_linux_amd64/config.json
3. 以下の内容を編集します。
{
"http-bind-address": ":9090"
}
4. 以前の InfluxDB プロセスを開始する前に、必ず停止してください。
ps -ef | grep influxd | grep -v grep | awk '{print $2}' | xargs kill
5. もう一度起動して効果を確認します。
./influxd
6. ポートが 9090 に変更されたことがわかります。という構成も効果的です。
15.4.4 概要
1. 最後に、設定を変更したい場合は、InfluxDB の公式ドキュメントを参照することをお勧めします。この部分は非常に明確に書かれており、公式 Web サイトには設定用のさまざまなテンプレートが提供されています。公式ドキュメントを上手に活用することで開発効率が大幅に向上します。