カスタムフィールド管理
カスタムフィールドを使用すると、NQLデータモデルを追加フィールドで拡張できます。カスタムフィールドには三つのタイプがあります：
手動カスタムフィールドでは、外部システムからデータをインポートして、レポート作成や分析用にインベントリオブジェクトを拡充できます。 Nexthink Webインターフェイスでオブジェクトにタグを割り当て、特定のキャンペーンユーザーを対象にしたり、変更管理用のパイロットグループを作成したりできます。
計算カスタムフィールドでは、NQLクエリで定義した値を追跡でき、頻繁に実行するクエリの時間を節約できます。データモデルの要素として計算を追加すると、Checklistsなど、製品のさまざまな部分で結果を利用しやすくなります。
ルールベースのカスタムフィールドでは、NQLクエリとして表現された事前定義済みの基準に従って、オブジェクトを自動的に分類できます。最も関連性の高い軸に従ってデータセットを分類し、Investigationsで保守とアクセスが容易な、頻繁に使用するフィルターを設定できます。
カスタムフィールド名には#文字が接頭辞として付くため、NQLクエリ内で識別できます。
Libraryからインストールされたカスタムフィールド
Nexthinkは、Nexthink Libraryから手動でインストールできる、一連の事前構成済みカスタムフィールドを提供します。事前定義済みカスタムフィールドをインストール、管理、更新するには、Nexthinkインスタンス内のNexthink Libraryモジュールに移動します。
詳細については、Nexthink Libraryドキュメントを参照してください。
新しいカスタムフィールド
カスタムトレンドをゼロから作成すると、ニーズとユースケースに応じて必要なデータを表示できます。このページの新しいカスタムフィールドの作成セクションを参照してください。
カスタムフィールドへのアクセス
メインメニューからAdministrationを選択します。
ナビゲーションパネルのContent Managementセクションで、Custom fieldsをクリックします。
メニュー項目が表示されない場合は、ロールに適切な権限があることを確認してください。
カスタムフィールドの管理
Custom fields administrationページには、すべてのカスタムフィールドが表形式で一覧表示されます。
各カスタムフィールドにカーソルを合わせると、表の右側にアクションメニューが表示されます。アクションメニューのオプションは次のとおりです：
Edit：カスタムフィールドを設定します。
**タグを管理：**カスタムフィールドに複数のタグを追加します。
Delete：カスタムフィールドを削除します。
Export：カスタムフィールドをJSONファイル形式でエクスポートし、Nexthinkクラウドインスタンスの他のインスタンスと共有します。
Copy NQL ID：カスタムフィールドから情報を取得するNQLクエリを記述するときに、NQL IDを使用します。
ページの右上には、さまざまなタスクを実行するための三つのボタンがあります：
New custom fieldボタンをクリックして、カスタムフィールドを追加および設定します。詳細については、新しいカスタムフィールドの作成セクションを参照してください。
Importボタンをクリックして、JSONファイル形式のカスタムフィールドをインポートします。
ページ右上のアクションメニューをクリックし、Update valuesを選択します。詳細については、CSVファイルをインポートしてカスタムフィールドを更新するセクションを参照してください。
カスタムフィールドリストのフィルタリング
リスト上部のフィルターを使用して、作業対象のカスタムフィールドに絞り込みます。フィルター条件:
作成元: カスタムフィールドの作成方法。
タグ: カスタムフィールドに割り当てられたタグ。
タイプ: カスタムフィールドのタイプ。
オブジェクト: カスタムフィールドが適用されるオブジェクト。
詳細については、フィルタリング機能を参照してください。
カスタムフィールドへのタグの追加
カスタムフィールドを検索およびインデックス登録しやすくするために、タグを作成または再利用できます。任意のカスタムフィールドのアクションメニューから：
Manage tagsを選択します。
新しいタグまたは既存のタグの名前を入力します。コンテキストメニューに一致するタグのリストが表示されます。一致するものがない場合、システムは新しいタグを作成します。
必要に応じて、タグをさらに追加するか、特定の色を指定します。
タグをSaveします。
ダッシュボードの最も右側にあるTagsメニューでは、名前を入力してタグを検索するか、現在カスタムフィールドに割り当てられているすべてのタグのリストからタグをクリックできます。
新しいカスタムフィールドの作成
New custom fieldボタンをクリックして、カスタムフィールドを追加および設定します。 Draftページが開きます。
以下の表に従って、Generalのフィールドに入力します：
名前
Investigationsページに表示される名前です。
NQL ID
システムは、クエリ内でNQL IDを使用してカスタムフィールドを参照します。 Nexthinkは、カスタムフィールド名に基づいてNQL IDを提案します。カスタムフィールドを保存すると、NQL IDは編集できません。
説明 (オプション)
他のユーザーがカスタムフィールドの意味を理解できるように、任意のテキストを入力します。
カスタムフィールドのTypeを選択します。選択できるオプションは三つあります：
手動カスタムフィールドタイプの選択
TypeでManualを選択します。
Objectドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します：Device、User、Binary、またはPackage。
詳細については、手動カスタムフィールドの値の設定セクションを参照してください。
計算カスタムフィールドタイプの選択
Type.でComputedを選択します
各行に
devicesの計算結果を含む、単一列の表を返すNQLクエリを記述します。
以下に、**CPU Queue length (24h)**カスタムフィールドの例を示します。
以下の表は、上記のComputed Typeの例のフィールド入力を示しています：
名前
CPUキューの長さ（24時間）
NQL ID
#cpu_queue_length_1hr
上記の例では、ユーザーがカスタムフィールド名を24時間の期間に更新しても、NQL IDには最初の1時間の期間が反映されたままです。
カスタムフィールドを保存すると、NQL IDは編集できないことに注意してください。
説明 (オプション)
過去24時間の平均長を表示します。キュー長が大きいほど、CPUパフォーマンスは低下します。最適なパフォーマンスを得るには、CPUキュー長をデバイスで使用可能な論理プロセッサ数の1.5倍未満にする必要があります。
NQLクエリ
以下のクエリコードを参照してください。
計算カスタムフィールド用のNQLクエリを記述するためのガイドライン
クエリの対象は
devicesコレクションである必要があります。クエリには
include句が一つだけ必要です。システムでは、
where句はinclude句の後にのみ使用できます。クエリには
compute句が一つだけ必要です。クエリは
list句と、事前に計算された単一のフィールドで終了する必要があります。システムでは、
sort、limit、summarize、with句は使用できません。クエリを含む計算カスタムフィールドを保存すると、異なるデータ型を返すクエリに変更することはできません。
ルールベースのカスタムフィールドタイプの選択
事前定義済みの条件に従ってオブジェクトを分類するには、TypeでRule-basedを選択します。
Objectドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します：Device、User、Binary、またはPackage。
ルールベースのカスタムフィールドの一般的なユースケースは次のとおりです：
ハードウェア仕様に基づいて、デバイスモデルをプレミアム、メインストリーム、または低価格に分類する。
搭載メモリに基づいてデバイスを分類する。
名前またはメールパターンに基づいて、ユーザーを内部または外部に分類する。
ビジネス継続性における重要度に基づいて、パッケージおよびバイナリを分類する。
コンプライアンスのために、パッケージまたはバイナリのブロックリストを定義する。
各ルールは次の属性によって特徴付けられます：
値
ルールを満たすすべてのオブジェクトに付与されるラベルです。
評価
ルールに付与される評価値：Poor、Average、またはGood。デフォルトでは、Noneに設定されます。
NQLクエリ
ルールの評価時に実行されるクエリです。
ルールベースのカスタムフィールド用NQLクエリには、次の制約があります：
クエリは、カスタムフィールドが定義されているオブジェクトを対象にする必要があります。たとえば、デバイスのカスタムフィールドの場合は
devicesです。クエリには少なくとも一つの
where句が必要です。with、include、summarize、compute、list句は使用できません。during past、from、toなどの期間指定は使用できません。クエリで参照できるのはネイティブオブジェクトのプロパティのみです
搭載メモリプロファイルのルールベースの例
このセクションでは、搭載メモリに基づいてデバイスを分類するルールベースのカスタムフィールドの例を示します。フィールド入力とルールは次のとおりです：
名前：Memory Profile
NQL ID：
#memory_profile**説明：**搭載メモリに基づいてデバイスを分類します。
**オブジェクト：**Device
| ルール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のデバイスには、NQLクエリの条件を最初に満たすRule 2に従って、Installed_memory_8_to_16_GBのタグが付与されます。
Investigationsページでは、ルールベースのカスタムフィールドを使用するNQLクエリを実行して調査できます。
次のクエリは、デバイスのメモリプロファイルに応じたデバイスごとの実行クラッシュ数を返します：
結果をメモリ別に分類する代わりに、ルールで設定された評価別に分類することもできます：poor、average、good。
この場合、NexthinkはInstalled_memory_16_to_32_GBおよびInstalled_memory_over_32_GBを持つデバイスを、まとめてgoodと評価します。
手動カスタムフィールドの値の設定
カスタムフィールドを作成した後、次の方法で値を設定できます：
InvestigationsページのEditオプション。
手動カスタムフィールドを編集する権限には、View domainへの限定アクセスのみが必要です。
Custom fields administrationページのアクションメニューからUpdate valuesを実行。
Enrichment API：詳細については、Nexthink API Documentationを参照してください。
Nexthinkのワークフロー実行で、Update custom field Thinkletを使用して値を更新します。
値の設定方法にかかわらず、次の要件が適用されます：
バックスラッシュ
\および二重引用符"を除き、UTF-8文字がサポートされます。フィールド値ごとに最大64文字まで使用できます。
Investigationsページでのカスタムフィールドの編集
Investigationページでは、次の方法でカスタムフィールドを編集できます：
アクションメニュー
アクションバー
Export resultsオプション（一括編集）
アクションメニューを使用したカスタムフィールドの編集
Investigationsページから：
NQL結果表で、カスタムフィールドのアクションメニューからEditを選択します。
Edit custom fieldモーダルで、New valueフィールドの値を入力します。
変更を保存するには、Doneをクリックします。
アクションバーを使用したカスタムフィールドの編集
Investigationsページから：
編集するオブジェクトタイプ（たとえば
devices）のNQLクエリ結果について、ページ下部のアクションバーでEditオプションを選択します。
Edit custom fieldモーダルで：
Custom fieldドロップダウンメニューからカスタムフィールドを選択します。
New valueテキストフィールドに新しい値を入力します。
変更を保存するには、Doneをクリックします。
結果をエクスポートしてカスタムフィールドを一括編集する
Investigationsページから：
IDフィールドと編集するカスタムフィールドを含む調査を実行します。
結果をCSVファイルとしてExportします。
スプレッドシートエディターを使用してカスタムフィールド値を編集します。
編集したCSVファイルをImportします。
このページのCSVファイルの例では、ファイルの表形式の構成について説明しています。また、以下の画像は、調査ページから結果をExportする方法を示しています。
CSVファイルをインポートしてカスタムフィールドを更新する
Custom fieldsページから：
ページ右上のアクションメニューをクリックします。
Update valuesを選択して、複数のカスタムフィールドを一度にNexthink Webインターフェイスへインポートします。
Update valuesダイアログボックスで、次の条件を満たす有効なCSVファイルを選択します：
ファイルサイズが5MB未満であること。
ファイルエンコーディングがUTF-8であること（UTF-8-BOMはサポートされません）。
バックスラッシュ
\文字はサポートされません。フィールド区切り文字はコンマです。
フィールドデリミタは任意ですが、使用できるデリミタの種類は引用符
"のみです。
カスタムフィールド更新用CSVファイルの例
データをインポートするために、表形式のCSVファイルを構成します。
最初のカスタムフィールドでは、
A1またはA2の値がCSVファイルにリストされたすべてのデバイスに割り当てられます。二番目のカスタムフィールドでは、最初の三つのデバイスに値
Bが割り当てられます。device-4には#custom_field2の値が設定されません。以前に設定されていた場合、このCSVファイルにより#custom_field2の値がNULLに更新されます。
次の書式ルールに従ってください：
ヘッダーは明示的なオブジェクトタイプを含むNQL ID形式です。例：
device.name、device.#custom_field1。ファイルには少なくとも一つのID列が必要です。使用できるIDは次のとおりです：
device：
device.uid、device.nameuser：
user.uid、user.sid、user.upnbinary：
binary.uidpackage：
package.uid
権限
カスタムフィールドに適切な権限を設定するには：
メインメニューからAdministrationを選択します。
ナビゲーションパネルでRolesをクリックします。
新しいロールを作成するには、ページ右上のNew Roleボタンをクリックします。
または、既存のロールにカーソルを合わせて編集アイコンをクリックし、ロール設定を変更します。
Permissionsセクションで、Administrationまでスクロールし、Manage all custom fieldsを有効にします。これにより、ユーザーはカスタムフィールドの作成、編集、削除、および手動カスタムフィールドの値の設定を行えるようになります。この権限は、フルビュー ドメインを持つユーザーのみが使用できます。
Manage all custom fields権限を持つユーザーには、Manage all ratings権限が自動的に付与されます（ルールベースのカスタムフィールドを設定するユーザー権限を付与します）。
それ以外の場合、Edit manual custom fields権限は、限定ビュー ドメインを持つユーザーに付与できます。
この権限は、Manage all custom fields権限を持つユーザーに自動的に付与されます。
最終更新
役に立ちましたか？