カスタムフィールド管理

カスタムフィールドを使用すると、NQLデータモデルを拡張して追加のフィールドを加えることができます。 カスタムフィールドには3つの種類があります:

• 手動カスタムフィールドは、外部システムからデータをインポートしてインベントリオブジェクトを豊かにし、レポート作成や分析に利用できます。 NexthinkのWebインターフェースでオブジェクトにタグを割り当てて、特定のキャンペーンユーザーをターゲットにしたり、変革管理のためにパイロットグループを作成できます。

• 計算カスタムフィールドは、NQLクエリで定義された値を追跡し、頻繁に実行されるクエリにかかる時間を節約できます。 データモデルに計算を要素として追加することで、チェックリストなどさまざまな製品部分でその結果を使用しやすくなります。

• ルールベースのカスタムフィールド は、あらかじめ定義された基準に従ってオブジェクトを自動的に分類でき、これら基準は各々NQLクエリで表現されます。 関連性の高い軸に基づいてデータセットを分解し、調査で簡単に管理しアクセスできる頻繁に使用されるフィルターを設定できます。

カスタムフィールド名は#文字で始まり、NQLクエリ内で識別可能です。

Nexthinkプラットフォームでは、各タイプに対するカスタムフィールドの数に制限があります:

最大100個の手動カスタムフィールド。

最大200個の計算カスタムフィールド。

最大200個のルールベースカスタムフィールド。

詳細については、Nexthink Infinityの閾値と制限の概要ドキュメントを参照してください。

---

ライブラリからインストールされたカスタムフィールド

Nexthinkは、Nexthinkライブラリから手動でインストールできる一連の事前設定されたカスタムフィールドを提供しています。 Nexthinkインスタンス内のNexthinkライブラリモジュールに移動して、事前定義されたカスタムフィールドをインストール、管理、および更新します。

詳細については、Nexthinkライブラリ ドキュメントを参照してください。

新しいカスタムフィールド

最初からカスタムトレンドを作成することで、目的やユースケースに合わせてデータを表示できます。 このページの新しいカスタムフィールドの作成セクションを参照してください。

---

カスタムフィールドへのアクセス

• メインメニューから管理を選択します。

• コンテンツ管理セクションのナビゲーションパネルでカスタムフィールドをクリックします。

メニュー項目が表示されない場合は、役割に適切な権限が付与されていることを確認してください。

---

カスタムフィールドの管理

カスタムフィールド管理ページでは、すべてのカスタムフィールドがテーブル形式で一覧表示されます。

• 各カスタムフィールドにカーソルを合わせると、テーブル右側にアクションメニューが表示されます。 アクションメニューのオプションは以下の通りです:

  • 編集: カスタムフィールドを設定します。

  • タグを管理: カスタムフィールドに1つまたは複数のタグを追加します。

  • 削除: カスタムフィールドを削除します。

  • エクスポート: カスタムフィールドをJSONファイル形式でエクスポートし、他のNexthinkクラウドインスタンスと共有します。

  • NQL IDをコピー: NQLクエリを記述してカスタムフィールドから情報を取得するときにNQL IDを使用します。

• ページの右上隅には、さまざまなタスクを行うための3つのボタンがあります:

  • 新しいカスタムフィールドボタンをクリックして、カスタムフィールドを追加および設定します。 詳細については、新しいカスタムフィールドの作成セクションを参照してください。

  • インポートボタンをクリックして、カスタムフィールドをJSONファイル形式でインポートします。

  • ページの右上隅にあるアクションメニューをクリックし、値を更新を選択します。 詳細については、CSVファイルのインポートによるカスタムフィールドの更新セクションを参照してください。

カスタムフィールドにタグを追加

カスタムフィールドの検索とインデックス化を容易にするために、タグを作成または再利用できます。 任意のカスタムフィールドのアクションメニューから:

• タグを管理を選択します。

• 新しいタグまたは既存のタグの名前を入力します。 コンテキストメニューには、一致するタグのリストが表示されます。 一致するものがない場合は、システムが新しいタグを作成します。

• オプションで、タグの追加または特定の色の追加を行います。

• タグを保存します。

ダッシュボードの最右側にあるタグメニューを使用して、名前を入力するか、現在カスタムフィールドに割り当てられているすべてのタグのリストからクリックしてタグを検索できます。

---

新しいフィールドの作成

新しいカスタムフィールドボタンをクリックして、カスタムフィールドを追加および設定します。 これにより、ドラフトページが開きます。

以下の表に従って、一般の下のフィールドに入力します。

フィールド	説明
名前	調査のページで表示される名前です。
NQL ID	システムはクエリ内でカスタムフィールドを参照するためにNQL IDを使用します。 Nexthinkはカスタムフィールド名に基づいてNQL IDを提案します。 カスタムフィールドを保存した後、NQL IDは編集できません。
説明 (オプション)	カスタムフィールドの意味を他のユーザーに理解してもらうために、オプションでテキストを入力します。

カスタムフィールドのタイプを選択します。 3つのオプションがあります:

• 手動タイプとオブジェクト

• NQLクエリを使用した計算タイプ

• ルールベースのタイプとオブジェクトおよびルール

手動カスタムフィールドタイプを選択する

• タイプで手動を選択します。

• オブジェクト ドロップダウンメニューから、カスタムフィールドを適用するオブジェクトを選択します: デバイス、ユーザー、バイナリ、または パッケージ。

手動カスタムフィールドの値の設定セクションを参照してください。

計算カスタムフィールドタイプを選択する

• タイプで計算を選択します。

• 各行に devices の計算結果が表示される単一列のテーブルを返す NQL クエリー を作成します。

以下の例を参考にして、CPU待ち行列の長さ (24h) カスタムフィールドを確認してください。

上記の計算タイプ例のフィールド入力は次のとおりです:

フィールド	入力 (例)
名前	CPU待ち行列の長さ (24h)
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 コレクションを対象とする必要があります。

• クエリーには include句が正確に1つ必要です。

• システムでは、include句の後にのみ where句が許可されます。

• クエリーには compute 句が正確に1つ必要です。

• クエリーは list 句と単一の数字の計算済みフィールドで終わる。

• システムでは 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クエリーを実行することで、調査を実施できます。

次のクエリーは、デバイスのメモリプロファイルに応じて、デバイスごとの実行クラッシュ数を返します：

execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile

結果をメモリで分解せずに、ルールで設定された格付け: poor、average、good で分解することもできます。

この場合、Nexthink は Installed_memory_16_to_32_GB および Installed_memory_over_32_GB を持つデバイスを good と評価します。

execution.crashes during past 30d
| summarize crash_ratio = count()/device.count() by device.#memory_profile.rating

---

手動カスタムフィールドの値を設定する

カスタムフィールドを作成した後、その値を次の方法で設定できます：

• インベスティゲーションページ上の編集オプション。

  • 手動カスタムフィールドを編集する権限は、View domainへの限定アクセスだけで十分です。

• カスタムフィールド管理ページのアクション メニューから値の更新を行います。

• Enrichment APIについては、Nexthink APIドキュメンテーションを参照してください。

• Nexthinkワークフローの実行内のカスタムフィールドの更新 思考ユニットを使用して、値を更新します。

次の要件は、値を設定するために選択したオプションに依存せずに適用されます：

• UTF-8文字はバック スラッシュ\と二重引用符"を除いてサポートされます。

• フィールドの値は1つにつき最大64文字まで許可されています。

インベスティゲーションページ上のカスタムフィールドの編集

次の方法で、インベスティゲーションページでカスタムフィールドを編集できます：

• アクションメニュー。

• アクションバー。

• 結果をエクスポートするオプション (一括編集)。

アクションメニューでのカスタムフィールドの編集

インベスティゲーション ページから：

• NQL結果テーブルのカスタムフィールドに対するアクションメニューから編集を選択します。

• カスタムフィールドを編集 モーダルで、新しい値フィールドに値を入力します。

• 変更を保存するには完了をクリックします。

アクションバーでのカスタムフィールドの編集

インベスティゲーション ページから：

1. ページ下部のアクションバーにある編集オプションを選択して、編集したいオブジェクトタイプ、例えばdevicesのNQLクエリ結果を確認します。

編集オプションが表示されない場合は、役割が正しい権限を持っていることを確認してください。

1. カスタムフィールドを編集モーダルにて。

   • カスタムフィールドドロップダウンメニューからカスタムフィールドを選択します。

   • 新しい値テキストフィールドに新しい値を入力します。

   • 変更を保存するには、完了をクリックします。

アクションバーでは、ページで完全に読み込まれて表示されていない大量の調査結果の一括編集はできません。

結果をエクスポートしてカスタムフィールドを一括編集

インベスティゲーションページから：

• IDフィールドおよび編集するカスタムフィールドで調査を実施します。

• 結果をCSVファイルとしてエクスポートします。

• スプレッドシートエディタを使用してカスタムフィールドの値を編集します。

• 編集したCSVファイルをインポートします。

このページのCSV ファイルの例は、ファイルの表形式の構成を説明しています。 さらに、以下の画像は調査ページから結果をエクスポートする方法を示しています。

CSVファイルのインポートによるカスタムフィールドの更新

Nexthinkのワークフローの実行内のカスタムフィールドの更新思考ユニットを使用して、手動カスタムフィールドの値を更新することもできます。

カスタムフィールドページから：

• ページの右上隅にあるアクションメニューをクリックします。

• 複数のカスタムフィールドを一度にNexthinkのWebインターフェースにインポートするには、値を更新を選択します。

• 値を更新ダイアログボックスで、有効な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,

  • 最初のカスタムフィールド用に、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

user.upn: UPNコレクションがコレクタレベルでクリアテキストとして有効になっている場合、ユーザー更新の前提条件です。 これは以下のライブラリーコンテンツで実現できます：

https://www.nexthink.com/library/#set-anonymization-features-windows

https://www.nexthink.com/library/collector-configuration#set-anonymization-features-macos

権限

カスタムフィールドの適切な権限を有効にするには：

• メインメニューから管理を選択します。

• ナビゲーションパネルから役割をクリックします。

• ページの右上隅にある新しい役割ボタンをクリックして、新しい役割を作成します。

  • または、既存の役割を編集するには、上にマウスを持っていき、編集アイコンをクリックして役割設定を変更します。

• 権限セクションで下にスクロールし、管理を有効にして全てのカスタムフィールドを管理をクリックします。 これにより、ユーザーがカスタムフィールドを作成、編集、削除し、手動カスタムフィールドの値を設定できるようになります。 この権限はフルビュードメインを持つユーザーにのみ利用可能です。

  • 全てのカスタムフィールドを管理権限を持つユーザーには、自動的に全ての評価を管理する権限が与えられます（ルールベースのカスタムフィールドを設定するためのユーザー権利が付与されます）。

• それ以外の場合、手動カスタムフィールドの編集権限は限定ビュー ドメインを持つユーザーに付与できます。

  • この権限は全てのカスタムフィールドを管理権限を持つユーザーにも自動的に付与されます。

権限オプションの詳細な説明については、役割のドキュメントを参照してください。