カスタムフィールド管理

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

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

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

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

カスタムフィールドの名前に#文字が付加されていることで、NQLクエリで識別可能です。

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

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

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

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

詳しくは、Nexthink Infinity のしきい値と制限の概要 ドキュメントをご覧ください。

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

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

詳しくはNexthinkライブラリドキュメントをご覧ください。

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

新しいカスタムトレンドをゼロから作成することで、必要なデータをニーズやユースケースに基づいて表示できます。 詳しくは、新しいカスタムフィールドの作成をご覧ください。

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

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

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

メニューエントリが表示されない場合は、あなたの役割が適切な権限を持っていることを確認してください。

カスタムフィールド管理

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

  • 各カスタムフィールドの上にマウスを置くと、テーブルの右側にアクションメニューが表示されます。 アクションメニューのオプションは次のとおりです。

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

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

    • エクスポート:カスタムフィールドを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)\n| include device_performance.events 過去24時間\n| compute c1 = (cpu_queue_length.avg() / number_of_logical_processors.avg())\n| list c1

計算されたカスタムフィールドのためのNQLクエリを書くためのガイドライン

  • クエリは「デバイス集合」をターゲットとしなければなりません。

  • クエリは「インクルード句」を一つだけ持つ必要があります。

  • システムは「インクルード句」の後にのみ「where句」を許可します。

  • クエリは「コンピュート句」を一つだけ持つ必要があります。

  • クエリは、以前に計算されたフィールドを一つだけリストする「リスト句」で終了する必要があります。

  • システムは「ソート」、「リミット」、「サマライズ」、または「ウィズ句」を許可しません。

  • 計算されたカスタムフィールドを保存した後、そのクエリを異なるデータ型を返すように変更することはできません。

ルールベースのCustom field Typeを選択

  • あらかじめ設定された基準に従ってオブジェクトを並べ替えるには、Typeの下でルールベースを選択します。

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

ルールベースのカスタムフィールドの一般的な使用例は次のとおりです:

  • デバイスモデルをハードウェア仕様に基づいて、プレミアム、メインストリーム、またはバジェットに分類します。

  • インストールされたメモリに基づいてデバイスを分類します。

  • 名前やメールパターンに基づいて、ユーザーを内部または外部に分類します。

  • ビジネスの継続における重要性に応じて、パッケージやバイナリを分類します。

  • コンプライアンスのために、パッケージやバイナリのブロックリストを定義します。

ルールベースのカスタムフィールドには最大20のルールを含めることができます。

ルールベースのカスタムフィールドはドラッグ&ドロップで順序を変更できます。 システムは上から下へとルールを評価します。

各ルールの特性には次のようなものがあります:

ルールの属性
説明

ルールを満たすすべてのオブジェクトに付けられたラベルです。

評価

ルールに対する価値判断: 悪い(Poor), 平均(Average), または 良い(Good)。 デフォルトで、なし(None) に設定されています。

NQLクエリ

ルール評価時に実行されるクエリ。

ルールベースのカスタムフィールドのためのNQLクエリの制約を以下に考慮してください:

  • そのカスタムフィールドが定義されているオブジェクトをクエリのターゲットにしなければなりません。 例えば、デバイスカスタムフィールドの場合は「デバイス」となります。

  • クエリには少なくとも1つの「where句」が含まれていなければなりません。

  • 「with」、「include」、「summarize」、「compute」、および「list句」は許可されません。

  • 「during past」、「from」、「to」などの時間選択も許可されません。

  • クエリはネイティブオブジェクトプロパティのみを参照できます。

インストールメモリプロファイルのルールベースの例

このセクションは、インストールされたメモリに基づいてデバイスを分類するためのルールベースのカスタムフィールドの例を表示します。 これらはフィールド入力とルールです:

  • 名前: メモリプロファイル

  • NQL ID: #memory_profile

  • 説明: インストールされたメモリに基づいてデバイスを分類します。

  • オブジェクト: デバイス

| ルール1 |

  • 値: メモリ_0_to_8_GB

  • 評価: 悪い(Poor)

  • NQLクエリ: devices | where hardware.memory <= 8GB

| | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ルール2 |

  • 値: メモリ_8_to_16_GB

  • 評価: 平均(Average)

  • NQLクエリ: devices | where hardware.memory <= 16GB

| | ルール3 |

  • 値: メモリ_16_to_32_GB

  • 評価: 良い(Good)

  • NQLクエリ: devices | where hardware.memory <= 32GB

| | ルール4 |

  • 値: メモリ_32_GBより大

  • 評価: 良い(Good)

  • NQLクエリ: devices | where hardware.memory > 32GB

|

上記のルールを考慮すると、システムは16GBのメモリを持つデバイスに対してメモリ_8_to_16_GBとしてタグを付けます。これはNQLクエリの条件によって満たされる最初のルールであるためです。

調査ページから、ルールベースのカスタムフィールドを使用してNQLクエリを実行することで調査を行うことができます。

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

execution.crashes 過去30日間\n| summarize crash_ratio = count()/device.count() by device.#memory_profile

結果をメモリで分解するのではなく、ルールで設定された評価に基づいても分解できます: 悪い(Poor), 平均(Average), 良い(Good)

この場合、Nexthinkはメモリ_16_to_32_GBおよびメモリ_32_GBより大を共に良いとして評価します。

execution.crashes 過去30日間\n| summarize crash_ratio = count()/device.count() by device.#memory_profile.rating

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

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

  • 編集 (Edit) オプションは調査ページにあります。

  • カスタムフィールド管理ページのアクションメニューから、CSVファイルをインポートして値を更新します。

  • Enrichment API 次のリンクで詳細を参照してください: Nexthink APIドキュメント

値を設定するための選択オプションに独立した次の要件が適用されます:

  • UTF-8文字がサポートされますが、バックスラッシュ\と二重引用符"の文字はサポート外です。

  • フィールド値ごとに最大64文字が許可されます。

調査ページでのカスタムフィールドの編集

調査ページでカスタムフィールドを次の方法で編集できます。

アクションメニューを使用したカスタムフィールドの編集

調査ページから:

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

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

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

アクションバーを使用したカスタムフィールドの編集

調査 ページから:

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

編集 オプションが見当たらない場合は、役割 に正しい権限があることを確認してください。

  1. カスタムフィールドを編集 モーダルで:

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

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

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

アクションバーは、ページ上で完全に読み込まれて見える大規模な調査結果の一括編集を許可しません。

結果のエクスポートによるカスタムフィールドの一括編集

調査 ページから:

  • 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,
    • すべてのデバイスリストにある最初のカスタムフィールドには、CSVファイルで A1A2 の値が割り当てられます。

    • 最初の3つのデバイスには、2番目のカスタムフィールドとして 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 に基づいたユーザー更新の前提条件は、コレクターレベルでのクリアテキストとしてのUPNコレクションの有効化です。 以下のライブラリコンテンツを使用して達成できます:

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

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

権限

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

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

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

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

    • 既存の役割を編集するには、その上にカーソルを置き、編集アイコンをクリックして役割の設定を変更します。

  • 権限 セクションで、管理までスクロールダウンし、すべてのカスタムフィールドを管理 を有効にして、ユーザーがカスタムフィールドの作成、編集、削除、および手動カスタムフィールドの値の設定を許可します。

    • すべてのカスタムフィールドを管理 プライバレッジを持つユーザーには、(ルールベースのカスタムフィールドの設定を許可する)すべての評価を管理 権限が自動的に付与されます。

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

Last updated

Was this helpful?