カスタムフィールド管理
カスタムフィールドを使用すると、NQLデータモデルを拡張して追加のフィールドを持たせることができます。 カスタムフィールドには、以下の3つのタイプがあります:
手動カスタムフィールドでは、外部システムからデータをインポートして在庫オブジェクトを強化し、レポートや分析を行うことができます。 Nexthinkのウェブインターフェースでオブジェクトにタグを割り当てることで、特定のキャンペーンユーザーをターゲットにしたり、変更管理のためのパイロットグループを作成することができます。
計算式カスタムフィールドにより、NQLクエリで定義された値を追跡し、頻繁に実行されるクエリの時間を節約できます。 データモデルに計算を要素として追加することで、チェックリストなど、さまざまな製品部分で結果を使用しやすくしています。
ルールベースのカスタムフィールドを使用すると、NQLクエリで表現される事前定義された条件に基づいてオブジェクトを自動的に分類することができます。 最も関連性のある軸に沿ってデータセットを分類し、調査で簡単にメンテナンスおよびアクセスできる頻繁に使用されるフィルタを設定することができます。
カスタムフィールド名は#文字で始まり、NQLクエリで識別しやすくなっています。
ライブラリからインストールされたカスタムフィールド
Nexthinkは、Nexthinkライブラリから手動でインストールできる一連の事前設定されたカスタムフィールドを提供します。 Nexthinkのインスタンス内のNexthinkライブラリモジュールに移動して、事前定義されたカスタムフィールドをインストール、管理、および更新します。
詳細については、Nexthink Libraryドキュメントを参照してください。
新しいカスタムフィールド
スクラッチからカスタムトレンドを作成することで、使用ニーズとユースケースに応じて希望するデータを表示できます。 詳細については、新しいカスタムフィールドの作成を参照してください。
カスタムフィールドのアクセス
メインメニューから管理を選択します。
コンテンツ管理セクションのナビゲーションパネルでカスタムフィールドをクリックします。
メニュー項目が表示されない場合は、役割に適切な権限があることを確認してください。
カスタムフィールドの管理
カスタムフィールド管理ページでは、カスタムフィールドがすべてテーブル形式で整理されています。
各カスタムフィールドの上にカーソルを移動すると、テーブルの右側にアクションメニューが表示されます。 アクションメニューのオプションは次のとおりです:
編集: カスタムフィールドの設定を行います。
タグの管理: カスタムフィールドに一つ以上のタグを追加します。
削除: カスタムフィールドを削除します。
エクスポート: JSONファイル形式でカスタムフィールドをエクスポートし、他のNexthinkクラウドインスタンスで共有します。
NQL IDのコピー: NQLクエリを記述してカスタムフィールドから情報を取得する際にNQL IDを使用します。
ページの右上隅にある3つのボタンを使って、さまざまなタスクを実行できます:
新しいカスタムフィールドボタンをクリックして、カスタムフィールドを追加して設定します。 詳細については、新しいカスタムフィールドの作成セクションを参照してください。
インポートボタンをクリックして、JSONファイル形式でカスタムフィールドをインポートします。
ページの右上隅にあるアクションメニューをクリックし、値の更新を選択します。 CSVファイルをインポートしてカスタムフィールドを更新する詳細情報セクションを参照してください。
カスタムフィールドへのタグの追加
簡単に検索およびインデックス付けできるように、タグを作成または再利用できます。 どのカスタムフィールドにもあるアクションメニューから:
タグの管理を選択します。
新しいタグまたは既存のものの名前を入力します。 コンテキストメニューには一致するタグのリストが表示されます。 一致がない場合、システムは新しいタグを作成します。
オプションとして、より多くのタグや特定の色を追加します。
タグを保存します。
ダッシュボードの最右端にあるタグメニューでは、名前を入力するか、現在カスタムフィールドに割り当てられているすべてのタグのリストからクリックすることで検索できます。
新しいカスタムフィールドの作成
新しいカスタムフィールド ボタンをクリックして、カスタムフィールドを追加および設定します。 これで下書きページが開きます。
以下のテーブルに従って一般のフィールドに入力します。
名前
調査ページに表示される名前です。
NQL ID
システムはNQL IDを使用してクエリ内でカスタムフィールドを参照します。 Nexthinkはカスタムフィールド名に基づいてNQL IDを提案します。 カスタムフィールドを保存後はNQL IDを編集することはできません。
説明 (オプション)
他のユーザーがカスタムフィールドの意味を理解するのを助けるためにオプションのテキストを入力してください。
手動カスタムフィールドタイプの選択
タイプとして手動を選択します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します: デバイス、ユーザー、バイナリ、またはパッケージ。
手動カスタムフィールドの値設定については、詳細情報セクションを参照してください。
計算式カスタムフィールドタイプの選択
タイプとして計算式を選択します。
各行の
devices計算結果を含む単一列のテーブルを返す NQLクエリ を書きます。
以下の例は、**CPUキューの長さ（24時間）**のカスタムフィールドです。
上記の計算式タイプ例のフィールド入力は次のとおりです:
名前
CPUキューの長さ（24時間）
NQL ID
#cpu_queue_length_1hr
上記の例では、ユーザーがカスタムフィールド名を24時間枠に更新した場合でも、NQL IDは最初の1時間枠を反映します。
一度カスタムフィールドを保存すると、NQL IDを編集することはできません。
説明 (オプション)
過去24時間の平均長を表示します。キューの長さが長いほど、CPUのパフォーマンスは低下します。 最適なパフォーマンスを得るには、CPUキューの長さがデバイス上で利用可能な論理プロセッサの数の1.5倍未満であるべきです。
NQLクエリ
以下のクエリコードを参照してください。
devices
| include device_performance.events past 24h
| compute c1 = (cpu_queue_length.avg() / number_of_logical_processors.avg())
| list c1計算式カスタムフィールドのNQLクエリ記述ガイドライン
クエリは
devicesコレクションを対象にしなければなりません。クエリには1つの
include句だけが必要です。システムは
include句の後でのみwhere句を許可します。クエリには1つの
compute句だけが必要です。クエリは以前に計算された単一のフィールドと一緒に
list句で終了する必要があります。システムは
sort、limit、summarize、with句を許可しません。クエリで別のデータタイプを返すようにクエリを変更することはできません。
ルールベースカスタムフィールドタイプの選択
定義済みの基準に従ってオブジェクトを分類するには、タイプでルールベースを選択します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します: デバイス、ユーザー、バイナリ、またはパッケージ。
ルールベースカスタムフィールドの一般的な使用例には以下のものがあります:
デバイスモデルをハードウェア仕様に基づいてプレミアム、メインストリーム、または予算と分類します。
インストールされたメモリに基づいてデバイスを分類します。
名前やメールパターンに基づいてユーザーを内部または外部と分類します。
ビジネス継続性のための重要度に基づいてパッケージやバイナリを分類します。
コンプライアンスのためにパッケージまたはバイナリのブロックリストを定義します。
各ルールの属性は以下のように特徴付けられます:
値
ルールを満たすすべてのオブジェクトに付されるラベルです。
評価
ルールに付される価値の判断: 悪い、普通、または良い。 デフォルトではなしに設定されています。
NQLクエリ
ルールの評価時に実行されるクエリです。
ルールベースカスタムフィールドのNQLクエリに関する制約を考慮してください:
クエリはカスタムフィールドが定義されているオブジェクトを対象としなければなりません。 たとえば、デバイスカスタムフィールドには
devicesが対象になります。クエリには少なくとも1つの
where句があります。with、include、summarize、compute、list句は許可されていません。during past、from、toといった時間選択肢は許可されていません。クエリはネイティブオブジェクトのプロパティのみを参照できます。
インストールされたメモリプロファイルのルールベース例
このセクションでは、インストールされたメモリに基づいてデバイスを分類するためのルールベースカスタムフィールドの例を示します。 これらがフィールド入力とルールです:
名前: メモリプロファイル
NQL ID:
#memory_profile説明: インストールされたメモリに基づいてデバイスを分類します。
オブジェクト: デバイス
| ルール1 | 値: インストールメモリ0〜8GB 評価: 悪い NQLクエリ: devices | where hardware.memory <= 8GB | | --- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | ルール2 | 値: インストールメモリ8〜16GB 評価: 普通 NQLクエリ: devices | where hardware.memory <= 16GB | | ルール3 | 値: インストールメモリ16〜32GB 評価: 良い NQLクエリ: devices | where hardware.memory <= 32GB | | ルール4 | 値: インストールメモリ32GB以上 評価: 良い NQLクエリ: devices | where hardware.memory > 32GB |
上のルールに従うと、システムは16GBのインストールメモリを持つデバイスを インストール_メモリ_8_to_16_GB とタグ付けします。NQLクエリの条件を最初に満たしたルール2が適用されるためです。
調査ページから、NQLクエリを使用して、ルールベースのカスタムフィールドを使って調査を実行できます。
次のクエリは、デバイスのメモリプロファイルに応じて、デバイスごとの実行クラッシュ数を返します:
execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile
結果をメモリで分類する代わりに、ルールに設定された評価で分類することもできます: 悪い、普通、良い。
この場合、Nexthinkはデバイスのインストール_メモリ_16_to_32_GBおよびインストール_メモリ_32_GB以上を一緒に良いと評価します。
execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile.rating
手動カスタムフィールドの値設定
カスタムフィールドを作成した後、その値を以下の方法で設定できます:
カスタムフィールド管理ページのアクションメニューから値を更新する。
Enrichment APIについては、詳細はNexthink API ドキュメンテーションを参照してください。
値を設定するオプションによらず、以下の要件が適用されます。
UTF-8文字がサポートされていますが、バックスラッシュ
\とダブルクォーテーション"は使用できません。フィールド値には最大64文字まで許可されています。
Investigations ページでカスタムフィールドを編集
以下にアクセスすることで、Investigations ページでカスタムフィールドを編集できます：
結果のエクスポートオプション（一括編集）
アクションメニューを使ってカスタムフィールドを編集する
Investigations ページから：
NQL 結果テーブル内のカスタムフィールド用のアクションメニューから 編集 を選択します。
カスタムフィールドを編集モーダルで新しい値フィールドの値を入力します。
変更を保存するには、完了をクリックします。
アクションバーを使ってカスタムフィールドを編集する
Investigations ページから：
編集したいオブジェクトタイプ、例えば"devices"のNQLクエリ結果に応じて、ページの下部にあるアクションバーで編集オプションを選択します。
カスタムフィールドを編集モーダルで：
カスタムフィールド ドロップダウンメニューからカスタムフィールドを選択します。
新しい値 テキストフィールドに新しい値を入力します。
変更を保存するには、完了 をクリックします。
結果をエクスポートしてカスタムフィールドを一括編集する
Investigations ページから：
IDフィールドと編集するカスタムフィールドを使用して調査を実行します。
結果をCSVファイルとしてエクスポートします。
スプレッドシートエディタでカスタムフィールドの値を編集します。
編集されたCSVファイルをインポートします。
このページのCSVファイルの例 は、ファイルの表形式の構成について説明しています。 さらに、以下の画像は、調査ページから結果をエクスポートする方法を示しています。
カスタムフィールドをCSVファイルのインポートで更新する
カスタムフィールド ページから：
ページの右上隅にあるアクションメニューをクリックします。
いくつかのカスタムフィールドを一度に Nexthink ウェブインターフェースにインポートするには、値を更新 を選択します。
値を更新 ダイアログボックスで、次の基準を満たしていることを確認し、有効なCSVファイルを選択します。
ファイルサイズが5MB未満であること。
ファイルのエンコーディングはUTF-8（UTF-8-BOMはサポートされていません）。
バックスラッシュ
\文字はサポートされていません。フィールドセパレーターはカンマです。
フィールドデリミタはオプションであり、クォート
"のみが許可されているデリミタタイプです。
カスタムフィールド更新のためのCSVファイルの例
データをインポートするための表形式でCSVファイルを構成します。
device.name,device.#custom_field1,device.#custom_field2 device-1,A1,B device-2,A1,B device-3,A2,B device-4,A2,値
A1またはA2がCSVファイルに記載されたすべてのデバイスに対して最初のカスタムフィールドに割り当てられます。値
Bは、2番目のカスタムフィールドに対して最初の3つのデバイスに割り当てられます。device-4の#custom_field2は設定されていません。 以前設定されていた場合、このCSVファイルは#custom_field2の値をNULLに更新します。
次の形式ルールに従ってください。
ヘッダーは明示的なオブジェクトタイプを持つNQL ID 形式です。例えば、
device.nameやdevice.#custom_field1。ファイルには少なくとも1つのID列があります。 次のIDが受け入れられます。
デバイス：
device.uid,device.nameユーザー：
user.uid,user.sid,user.upnバイナリ：
binary.uidパッケージ：
package.uid
権限
カスタムフィールドの適切な権限を有効にするには：
メインメニューから 管理 を選択します。
ナビゲーションパネルから ロール をクリックします。
新しいロールを作成するには、ページの右上隅にある 新しいロール ボタンをクリックします。
または、既存のロールにカーソルを合わせ、編集アイコンをクリックしてロールの設定を変更します。
権限 セクションで、管理 をスクロールして すべてのカスタムフィールドを管理 を有効にします。 これにより、ユーザーがカスタムフィールドを作成、編集、削除し、手動カスタムフィールドの値を設定できるようになります。 この権限は フルビュー ドメイン を持つユーザーのみが利用可能です。
すべてのカスタムフィールドを管理 の権限を持つユーザーには自動的に すべての評価を管理 する権限が付与されます（ルールベースカスタムフィールドの設定に関する権限を提供）。
それ以外の場合、限定ビュー ドメイン のユーザーには 手動カスタムフィールドの編集 権限が付与できます。
この権限は すべてのカスタムフィールドを管理 の権限を持つユーザーに自動的に付与されます。
Last updated
Was this helpful?