Instana を解き放ち、新たな技術を観察する
Instana をセットアップして、新しいシステムや技術を監視できます。これには、 Instana のカスタムダッシュボードとイベント定義機能、および OpenTelemetry との連携機能を活用します。 公開ダッシュボード、イベント、再利用可能な統合パッケージを活用することで、必要な可観測性ソリューションを自ら実装できます。
統合パッケージの調査
npmjs などの中央レジストリ上で、統合パッケージにバンドルされた再利用可能なダッシュボードやイベント定義を検索する。 これらのパッケージを Instana 環境に統合する前に、機能性、インストール手順、その他の詳細を確認できます。 パッケージのレビューは、新たな可観測性機能の迅速な導入を保証します。 IBM 顧客やビジネスパートナーと共に、監視機能を強化するためにダウンロードしてインポートできる統合パッケージを提供しています。 以下の表は、利用可能なパッケージの例を示しています：
| 名前 | 説明 | リンク |
|---|---|---|
| オープンテレメトリー・デモ | Instana 統合パッケージは、コミュニティからフォークしたopentelemetry-demo プロジェクトの Instana 版である OpenTelemetry デモアプリケーションの監視を実演するために使用されます。 | オープンテレメトリー・デモ |
| go | Instana 統合パッケージは、 Go の監視をサポートするために使用されていました。 | go |
| NodeJS | Instana 統合パッケージは、 Node.js の監視をサポートするために使用されていました。 | NodeJS |
ダッシュボードおよびイベント定義のダウンロード、インポート、エクスポート
再利用可能なダッシュボードとイベント定義は統合パッケージにバンドルされ、公開されているため、監視対象とするシステムや技術をサポートするパッケージを選択できます。 必要なパッケージをダウンロードし、既存の Instana 環境にインポートしてください。 パッケージをインポートすると、 Instana 環境の機能が即座に拡張され、新しいシステムやテクノロジーの可観測性をサポートできるようになります。
統合パッケージ管理には、コマンドラインツールである Instana CLIを使用して、統合パッケージのダウンロード、インポート、エクスポートを行うことができます。 このツールを使用すると、再利用可能なダッシュボードやイベント定義を含むパッケージのライフサイクルを管理できます。 ツールの最新バージョンをダウンロードするには、 Instana CLI for integration パッケージ管理のリリースページを参照してください。
詳細については、 CLIドキュメントページで利用例とサポートされているコマンドをご確認ください。
ダッシュボードとイベント定義のダウンロード
ツールを使用して再利用可能なダッシュボードとイベント定義を含む統合パッケージをダウンロードするには、パッケージ名を指定する必要があります。 以下のサンプルコマンドを参照して、名前のパッケージをダウンロード @instana-integration/goしてください：
$ stanctl-integration download --package @instana-integration/go
デフォルトでは、ツールは現在の作業ディレクトリ内にサブディレクトリを作成し、ダウンロードしたすべての統合パッケージを保存するルートディレクトリとします。 パッケージ用のルートディレクトリを指定するには、オプション --location を使用することもできます。 たとえば、次のコマンドはルートディレクトリ下のパッケージをダウンロード ./my-packagesします：
$ stanctl-integration download --package @instana-integration/go --location ./my-packages
ダッシュボードとイベント定義のインポート
統合パッケージをローカルマシンにダウンロードしたら、このツールを使用してダッシュボードとイベント定義を既存の Instana 環境にインポートできます。 ツールを実行する際には、対応するオプションを使用して、 Instana のサーバーアドレスと API のトークンを指定する必要があります。 API トークンが必要なのは、ツールがダッシュボードとイベント定義のインポートを完了するために一連の Instana APIを呼び出すためです。 以下の例を参照してください。
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN
ディレクトリはオプション --location を使用して指定できます。 例:
$ stanctl-integration import --package @instana-integration/go --location ./my-packages \
--server $INSTANA_SERVER \
--token $API_TOKEN
Sharing custom
dashboards publicly with all users and API tokensする必要があります。 確認するには、 Instana のナビゲーションメニューを開き、 [設定] > [チーム設定] > [ API トークン ] の順に移動します。次に、[ API トークン] ページで、インポートに使用しているトークンを選択してください。 「 API トークンの編集」 ダイアログで、 「所有者の権限 」セクションを見つけ、[所有者の権限] 項目 Sharing custom
dashboards publicly with all users and API tokens が有効になっていることを確認してください。ダッシュボードのパラメータ値の指定
一部のダッシュボードでは、統合パッケージに含まれるダッシュボード定義にパラメータが含まれている場合があります。 これは、ダッシュボード管理者がダッシュボードを定義する時点で、ダッシュボード定義に現れる一部の値がまだ確定していない可能性があるためです。 このパッケージにパラメータが含まれているかどうかは、パッケージのホームページで確認できます。 このツールを使用してダッシュボードをインポートする際、オプション --set を使用してこれらのパラメータの実際の値を指定できます。このオプションは複数回使用可能です。 例:
$ stanctl-integration import --package @instana-integration/go \
--server $INSTANA_SERVER \
--token $API_TOKEN \
--set key1=value1 \
--set key2=value2
ダッシュボードとイベント定義のエクスポート
Instana CLI for integration package managementは、ダウンロードとインポートに加え、既存の Instana 環境からダッシュボードおよびイベント定義のエクスポートもサポートします。 ダッシュボードとイベント定義をエクスポートするには、 Instana サーバーアドレス、有効な API トークン、およびアセットの種類（ダッシュボードまたはイベント）を指定する少なくとも 1 つの --include オプションを提供する必要があります。 エクスポート対象の特定の要素を識別するには、アセットタイプに加えて、タイトルまたはIDのいずれかを指定する必要があります。 このツールは Instana のAPIを使用して一致するアセットを取得し、ポータブル形式でローカルに保存します。 以下の例では、タイトルを一致させることでダッシュボードとイベント定義がエクスポートされます：
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=dashboard title="dashboardTitle"
あるいは、ダッシュボードまたはイベントのIDがわかっている場合は、そのIDを指定して直接エクスポートできます。 以下の例を参照してください。
$ stanctl-integration export --server $INSTANA_SERVER \
--token $API_TOKEN \
--include type=event id=eventID