カスタムフィールド管理
カスタムフィールドを使用すると、NQLデータモデルに追加フィールドを拡張できます。 カスタムフィールドには3種類あります：
手動のカスタムフィールドを使用すると、外部システムからデータをインポートしてインベントリオブジェクトを充実させ、レポートや分析を行うことができます。 Nexthink web インターフェースでオブジェクトにタグを割り当てて、特定のキャンペーンユーザーをターゲットにしたり、変更管理のためにパイロットグループを作成したりできます。
計算されたカスタムフィールドを使用すると、NQLクエリで定義された値を追跡でき、頻繁に実行されるクエリの時間を節約できます。 データモデルの要素として計算を追加することで、結果をチェックリストなどの様々な製品部分で便利に使用できます。
ルールベースのカスタムフィールドを使用すると、NQLクエリとして表現されたあらかじめ定義された基準に基づいてオブジェクトを自動的に分類できます。 データセットを最も関連性の高い軸に沿って分解し、調査において簡単にアクセスし維持が容易なフィルターを設定できます。
カスタムフィールド名には #文字が付加されており、NQLクエリ内で識別可能です。
Nexthinkプラットフォームは、各種類のカスタムフィールドの数に制限を設けています：
最大100個の手動カスタムフィールド。
最大200個の計算されたカスタムフィールド。
最大200個のルールベースのカスタムフィールド。
詳細については、Nexthink Infinity のしきい値と制限の概要 ドキュメントを参照してください。
ライブラリからインストールされたカスタムフィールド
Nexthinkでは、Nexthinkライブラリから手動でインストールできる一連のプリセット済みカスタムフィールドを提供しています。 Nexthink インスタンス内の Nexthink Library モジュールにアクセスして、プリセットカスタムフィールドをインストール、管理、更新します。
詳細については、Nexthink Library ドキュメントを参照してください。
新しいカスタムフィールド
一からカスタムトレンドを作成して、ニーズやユースケースに応じて必要なデータを表示できます。 詳細については、新しいカスタムフィールドの作成 を参照してください。
カスタムフィールドへのアクセス
メインメニューから 管理 を選択します。
コンテンツ管理セクションにあるナビゲーションパネルで カスタムフィールド をクリックします。
メニューエントリーが表示されない場合は、役割が適切な権限を持っていることをご確認ください。
カスタムフィールドの管理
カスタムフィールド管理ページでは、すべてのカスタムフィールドがテーブルに整理されています。
各カスタムフィールドにカーソルを合わせると、テーブルの右側にアクションメニューが表示されます。 アクションメニューのオプションは次のとおりです：
編集：カスタムフィールドを設定します。
削除：カスタムフィールドを削除します。
エクスポート：Nexthink cloud インスタンスの他のインスタンスと共有するために、JSONファイル形式でカスタムフィールドをエクスポートします。
NQL IDをコピー：NQLクエリの作成時にカスタムフィールドから情報を取得するためにNQL IDを使用します。
ページの右上に3つのボタンがあります：
カスタムフィールドを追加して設定するには、新しいカスタムフィールド ボタンをクリックします。 詳細については、新しいカスタムフィールドの作成セクションを参照してください。
JSONファイル形式でカスタムフィールドをインポートするには、インポート ボタンをクリックします。
ページの右上隅にあるアクションメニューをクリックし、値を更新 を選択します。 詳細については、CSVファイルをインポートしてカスタムフィールドを更新するセクションを参照してください。
新しいカスタムフィールドの作成
カスタムフィールドを追加して設定するには、新しいカスタムフィールド ボタンをクリックします。 これにより、ドラフト ページが開きます。
以下のテーブルに従って、一般項目を入力します：
名前
調査ページに表示される名前です。
NQL ID
システムはクエリでカスタムフィールドを参照する際にNQL IDを使用します。 Nexthinkはカスタムフィールド名に基づいてNQL IDを提案します。 NQL IDはカスタムフィールドを保存した後は編集できません。
説明（任意）
カスタムフィールドの意味を他のユーザーが理解するのを助けるために、任意のテキストを入力します。
手動カスタムフィールドタイプの選択
手動をタイプ以下で選択します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクト（デバイス、ユーザー、バイナリ、パッケージ）を選択します。
詳細については、手動カスタムフィールドに値を設定するセクションを参照してください。
計算されたカスタムフィールドタイプの選択
計算されたをタイプ以下で選択します。
それぞれの行に
デバイスの計算結果を返すシングルカラムのテーブルとなるNQLクエリを記述します。
以下に**CPUキュー長（24h）**の例を示します。
以下のテーブルは、上記の計算されたタイプの例のフィールド入力を示しています：
名前
CPUキュー長（24h）
NQL ID
#cpu_queue_length_1hr
上記の例では、カスタムフィールド名を24時間枠に更新しても、NQL IDは初めの1時間枠を反映したままです。
覚えておいてください、カスタムフィールドを保存した後は、NQL IDは編集できません。
説明（任意）
過去24時間の平均長を表示します。キュー長が大きいほど、CPUパフォーマンスが低下します。 最良のパフォーマンスを得るためには、CPUキュー長はデバイス上にある論理プロセッサの数の1.5倍未満であるべきです。
NQL クエリ
以下のクエリコードを参照してください。
計算されたカスタムフィールドのNQLクエリを書くためのガイドライン
クエリは
devicesコレクションを対象にしなければなりません。クエリには正確に1つの
include節が必要です。システムは、
include節の後にのみwhere節を許可します。クエリには正確に1つの
compute節が必要です。クエリは、
list節と以前に計算された1つのフィールドで終了しなければなりません。sort、limit、summarize、およびwith節は許可されていません。クエリを保存した後は、他のデータ型を返すようにクエリを変更することはできません。
ルールベースのカスタムフィールドタイプの選択
タイプでルールベースを選択し、定義済み基準に従ってオブジェクトを分類します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクト（デバイス、ユーザー、バイナリ、パッケージ）を選択します。
ルールベースのカスタムフィールドの一般的な使用例には次のものがあります：
ハードウェア仕様に基づいて、デバイスモデルをプレミアム、メインストリーム、または予算に応じて分類します。
インストールされているメモリに基づいてデバイスを分類します。
名前やメールパターンに基づいてユーザーを内部または外部と分類します。
ビジネス継続性のためにパッケージおよびバイナリを分類します。
コンプライアンスのためのパッケージまたはバイナリのブロックリストを定義します。
ルールベースのカスタムフィールドには最大20個のルールを含めることができます。
ルールベースのカスタムフィールドをドラッグアンドドロップして順序を変更できます。 システムはルールを上から下へと評価します。
各ルールを特徴付ける属性は次のとおりです：
値
ルールを満たすすべてのオブジェクトに紐付けられたラベル。
評価
ルールに添付される評価値：Poor、Average、Good。 デフォルトではNoneに設定されています。
NQLクエリ
ルールの評価時に実行されるクエリ。
ルールベースのカスタムフィールドに対するNQLクエリに関する以下の制約を考慮してください：
クエリはカスタムフィールドが定義されているオブジェクトを対象としなければなりません。 たとえば、デバイスカスタムフィールドには
devicesを指定します。クエリには少なくとも1つの
where節が必要です。with、include、summarize、compute、およびlist節は許可されていません。during past、from、toのような時間選択は許可されていません。クエリはネイティブオブジェクトのプロパティのみを参照できます。
インストール済みメモリプロファイルのルールベースの例
このセクションでは、インストール済みメモリに基づいてデバイスを分類するためのルールベースのカスタムフィールドの例を示します。 これらがフィールド入力およびルールです：
名前：メモリプロファイル
NQL ID:
#memory_profile説明: インストールされているメモリに基づいてデバイスを分類します。
オブジェクト: デバイス
| ルール1 |
値：Installed_memory_0_to_8_GB
評価：Poor
NQLクエリ：
devices | where hardware.memory <= 8GB
| | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ルール2 |
値：Installed_memory_8_to_16_GB
評価：Average
NQLクエリ：
devices | where hardware.memory <= 16GB
| | ルール3 |
値：Installed_memory_16_to_32_GB
評価：Good
NQLクエリ：
devices | where hardware.memory <= 32GB
| | ルール4 |
値：Installed_memory_over_32_GB
評価：Good
NQLクエリ：
devices | where hardware.memory > 32GB
|
上記のルールを考慮すると、システムはインストールされているメモリが16GBのデバイスに「Installed_memory_8_to_16_GB」とタグを付けます。この条件に満たされるNQLクエリの最初の条件であるためにルール2が最初に評価されます。
調査 ページから、ルールベースのカスタムフィールドを使用したNQLクエリを実行する調査を実施できます。
次のクエリは、デバイスのメモリプロファイルに基づいて、デバイスごとに発生したクラッシュの数を返します。
メモリによって結果を詳細化する代わりに、ルールにセットされた評価（Poor、Average、Good）によって詳細化することも可能です。
この場合、NexthinkはInstalled_memory_16_to_32_GBおよびInstalled_memory_over_32_GBのデバイスを一緒にGoodとして評価します。
手動カスタムフィールドの値を設定する
カスタムフィールドを作成すると、以下の方法でその値を設定できます：
編集 オプションをInvestigationsページで使用します。
カスタムフィールド管理ページのアクションメニューから値を更新します。
Enrichment API、詳細についてはNexthink API ドキュメントを参照してください。
値を設定するオプションに関係なく、次の要件が適用されます：
UTF-8文字はサポートされていますが、バックスラッシュ
\とダブルクオート"はサポートされていません。 フィールドごとに最大64文字まで許可されています。
Investigationsページでのカスタムフィールドの編集
Investigationsページにアクセスしてカスタムフィールドを編集できます：
結果をエクスポートするオプション（一括編集）
アクションメニューを使用してカスタムフィールドを編集する
Investigationsページから：
NQL結果テーブルのカスタムフィールドのアクションメニューから編集を選択します。
編集カスタムフィールドモーダルで新しい値フィールドに値を入力します。
完了をクリックして変更を保存します。
アクションバーを使用してカスタムフィールドを編集する
Investigationsページから：
例えば
デバイスなど、編集したいオブジェクトタイプに対するNQLクエリの結果に対して、ページの下部にあるアクションバーで編集オプションを選択します。
編集オプションが見えない場合は、役割に正しい権限があることを確認してください。
編集カスタムフィールドモーダルで：
カスタムフィールドドロップダウンメニューからカスタムフィールドを選択します。
新しい値テキストフィールドに新しい値を入力します。
完了をクリックして変更を保存します。
アクションバーでは、完全に読み込まれ表示されない大規模な調査結果のバルク編集はできません。
結果のエクスポートによるカスタムフィールドの一括編集
Investigationsページから：
IDフィールドと編集するカスタムフィールドで調査を実行します。
結果をCSVファイルとしてエクスポートします。
スプレッドシートエディターを使用してカスタムフィールドの値を編集します。
編集されたCSVファイルをインポートします。
このページのCSVファイルの例には、ファイルの表形式の構成が示されています。 さらに、以下の画像に調査ページからの結果をエクスポートする方法が表示されています。
CSVファイルをインポートしてカスタムフィールドを更新する
カスタムフィールドページから：
ページの右上隅にあるアクションメニューをクリックします。
複数のカスタムフィールドを一度にNexthink webインターフェースにインポートするため値を更新を選択します。
値の更新ダイアログボックスで、有効なCSVファイルを選択し、以下の基準を満たしていることを確認します：
ファイルサイズは5MB未満です。
ファイルのエンコーディングはUTF-8です（UTF-8-BOMはサポートされていません）。
バックスラッシュ
\文字はサポートされていません。フィールドセパレーターはカンマです。
フィールドデリミターはオプションで、引用符
"が唯一許可されるデリミターの種類です。
カスタムフィールドを更新するためのCSVファイルの例
データをインポートするために表形式の構造でCSVファイルを設定します。
最初のカスタムフィールドには全デバイスに
A1またはA2の値が割り当てられます。2番目のカスタムフィールドには、最初の3つのデバイスに
Bの値が割り当てられます。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
ユーザーの更新前提条件として、CollectorレベルでのユーザーUPN: UPNコレクションがクリアテキストとして有効化されます。 これは以下のLibraryコンテンツで達成できます：
https://www.nexthink.com/library/#set-anonymization-features-windows
https://www.nexthink.com/library/collector-configuration#set-anonymization-features-macos
権限
カスタムフィールドに適切な権限を設定するには：
メインメニューのAdministrationから選択します。
ナビゲーションパネルからRolesをクリックします。
ページの右上にある新しいロールボタンをクリックして新しいロールを作成します。
または、既存のロールを編集するにはその上にカーソルを移動して編集アイコンをクリックし、そのロールの設定を変更します。
Permissionsセクションで下へスクロールし、Administrationを選択し、ユーザーが手動カスタムフィールドの作成、編集、削除、および値設定ができるようにするためのManage all custom fieldsを有効にします。
Manage all custom fieldsの権限を持つ者には、自動的にManage all ratingsの権限が付与されます（ルールベースのカスタムフィールドを設定するためのユーザー権利付与）。
許可オプションの詳細な説明については、Rolesのドキュメントを参照してください。
Last updated
