カスタムフィールドの管理
カスタムフィールドは、NQLデータモデルに追加のフィールドを追加して拡張することを可能にします。 カスタムフィールドには3つの種類があります:
手動カスタムフィールドで、外部システムからデータをインポートして在庫オブジェクトを充実させ、レポートや分析を行うことができます。 Nexthinkウェブインターフェースでオブジェクトにタグを割り当て、特定のキャンペーンユーザーをターゲットにしたり、チェンジマネジメントのためのパイロットグループを作成したりできます。
計算カスタムフィールドで、NQLクエリーで定義された値をトラッキングして、頻繁に実行するクエリーの時間を節約できます。 データモデルの要素として計算を追加することにより、チェックリストなど様々な製品部分で結果を利用しやすくなります。
ルールベースのカスタムフィールドで、事前に定義された基準に従ってオブジェクトを自動的にソートできます。各基準はNQLクエリーで表現されます。 最も関連性の高い軸に従ってデータセットを分解し、頻繁に使用するフィルターをセットアップして、Investigationで簡単にメンテナンスしアクセスできます。
カスタムフィールド名は#文字で始まり、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つの選択肢があります:
手動タイプ with an Object
計算タイプwith an NQL クエリー
ルールベースのタイプ with an Object and Rules
手動カスタムフィールドのタイプを選択する
手動をタイプの下から選択します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します: デバイス、ユーザー、バイナリまたはパッケージ。
詳細については、手動カスタムフィールドの設定値セクションを参照してください。
計算によるカスタムフィールドのタイプを選択する
計算をタイプの下から選択します。
デバイス計算結果を各行に含む単一列テーブルを返すNQL クエリーを書きます。
以下の例を参照してください: CPUキュー長 (24h) カスタムフィールド。
上記の計算タイプ例のフィールド入力を次の表に示します:
名前
CPUキュー長 (24h)
NQL ID
#cpu_queue_length_1hr
上記の例では、ユーザーがカスタムフィールド名を24時間の時間枠に更新したとしても、NQL IDは初期1時間の時間枠を反映したままです。
記憶してください、カスタムフィールドを保存した後、NQL IDは編集することができない。
説明 (オプション)
過去24時間の平均長を表示します。キューの長さが長くなると、CPUのパフォーマンスが低下します。 最佳效能のために、CPUキューの長さは、デバイスに利用可能な論理プロセッサの1.5倍未満である必要があります。
NQL クエリー
下にクエリーコードを参照してください。
計算カスタムフィールドのためのNQLクエリーの書き方ガイドライン
クエリーは
デバイスコレクションを対象にしなければなりません。クエリーには、ちょうど1つの
include句が必要です。where句は、include句の後でのみ許可されます。クエリーには、ちょうど1つの
compute句が必要です。クエリーは、
list句と以前に計算されたフィールドで終わる必要があります。sort、limit、summarize、またはwith句は許可されていません。クエリーを使用して計算されたカスタムフィールドを保存した後、異なるデータタイプを返すためにクエリーを変更することはできません。
ルールベースのカスタムフィールドタイプの選択
事前定義された基準に従ってオブジェクトをソートするには、ルールベースをタイプの下から選択します。
オブジェクトドロップダウンメニューから、システムがカスタムフィールドを適用するオブジェクトを選択します: デバイス、ユーザー、バイナリまたはパッケージ。
ルールベースのカスタムフィールドの一般的なユースケースには次のようなものがあります:
ハードウェア仕様に基づいて、デバイスモデルをプレミアム、メインストリーム、または予算内で分類します。
インストールされたメモリに基づいてデバイスを分類します。
名前やメールパターンに基づいて、ユーザーを内部または外部として分類します。
ビジネスの継続性にとって重要なパッケージとバイナリを分類します。
コンプライアンスのためのパッケージまたはバイナリのブロックリストを定義します。
ルールベースのカスタムフィールドには最大で20のルールが含まれます。
ルールベースのカスタムフィールドをドラッグアンドドロップして順序を変更できます。 システムはルールを上から下へ評価します。
次の属性が各ルールを特徴づけます:
値
ルールを満足するすべてのオブジェクトに付けられるラベル。
格付け
ルールに付けられた価値判断:低<|vq_3694|>普通または良い**。 デフォルトではなしに設定されています。
NQL クエリー
ルールを評価する際に実行されるクエリー。
ルールベースのカスタムフィールドの値をソートする際に、値がアルファベット順または設定ページに表示されるルールの順に従うことは保証されていません。 むしろ、元々保存された順序に従います。
ルールベースのカスタムフィールドのNQLクエリーについて以下の制約を考慮してください。
クエリーはカスタムフィールドが定義されているオブジェクトを対象としなければなりません。 例えば、デバイスカスタムフィールドの場合は
デバイスです。クエリーには少なくとも1つの
where句が必要です。with,include,summarize,compute, およびlist句は許可されていません。during past,fromやtoなどの時間選択は許可されていません。クエリーはネイティブオブジェクトプロパティのみを参照することができます。
インストールされたメモリプロファイルのルールベースの例
このセクションでは、インストールされたメモリに基づいてデバイスを分類するためのルールベースのカスタムフィールドの例を示します。 これらはフィールド入力とルールです:
名前: メモリプロファイル
NQL ID:
#memory_profile説明: インストールされたメモリに基づいてデバイスを分類します。
オブジェクト: デバイス
| ルール1 |
値: Installed_memory_0_to_8_GB
格付け: 低
NQLクエリー:
devices | where hardware.memory <= 8GB
| | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ルール2 |
値: Installed_memory_8_to_16_GB
格付け: 普通
NQLクエリー:
devices | where hardware.memory <= 16GB
| | ルール3 |
値: Installed_memory_16_to_32_GB
格付け: 良い
NQLクエリー:
devices | where hardware.memory <= 32GB
| | ルール4 |
値: Installed_memory_over_32_GB
格付け: 良い
NQLクエリー:
devices | where hardware.memory > 32GB
|
上記のルールを考慮すると、16GBのインストールされたメモリを持つデバイスは、NQLクエリー条件を最初に満たすルール2に基づいてInstalled_memory_8_to_16_GBとしてタグが付けられます。
調査 ページから、NQL クエリーを使用してルールベースのカスタムフィールドで調査を実行できます。
次のクエリーは、デバイスのメモリプロファイルに基づいて、デバイスごとの実行クラッシュ数を返します：
結果をメモリごとに分類する代わりに、ルールに設定された評価（ poor 、 average 、 good ）で分類することもできます。
この場合、Nexthink は インストールメモリ16~32GB および インストールメモリ超32GB のデバイスを good と評価します。
手動カスタムフィールドの値設定
カスタムフィールドを作成したら、次の方法でその値を設定できます：
カスタムフィールド管理ページのアクションメニューから 値を更新 します。
Enrichment API、詳細についてはNexthink API ドキュメンテーション を参照してください。
Nexthink のワークフロー実行で、 カスタムフィールドの更新 Thinklet を使用して値を更新します。
値を設定するために選択したオプションにかかわらず、次の要件が適用されます：
UTF-8 文字がサポートされており、逆スラッシュ
\および二重引用符"の文字はサポートされていません。フィールド値ごとに最大64文字が許可されます。
調査ページでカスタムフィールドを編集する
次の手順により、調査ページでカスタムフィールドを編集できます：
アクションメニュー
アクションバー
エクスポート結果オプション（バルク編集）
アクションメニューを使用したカスタムフィールドの編集
調査ページから：
NQL 結果テーブルのカスタムフィールドに対するアクションメニューから 編集 を選択します。
カスタムフィールドを編集 モーダルで、 新しい値 フィールドに値を入力します。
変更を保存するには、 完了 をクリックします。
アクションバーを使用したカスタムフィールドの編集
調査ページから：
ページ下部のアクションバーで 編集 オプションを選択し、編集したいオブジェクトタイプ、例えば
devicesの NQL クエリーの結果を選択します。
編集 オプションが表示されない場合は、ロール に適切な権限があることを確認してください。
カスタムフィールドを編集 モーダル中：
カスタムフィールド ドロップダウンメニューからカスタムフィールドを選択します。
新しい値 テキストフィールドに新しい値を入力します。
保存するには 完了 をクリックします。
アクションバーはページ上で完全にロードされ、表示されていない調査結果の大規模なバルク編集を許可しません。
結果をエクスポートしてカスタムフィールドをバルク編集する
調査ページから：
ID フィールドと編集したいカスタムフィールドで調査を実行します。
結果をエクスポート CSV ファイルとして。
スプレッドシートエディタを使用してカスタムフィールド値を編集します。
編集した CSV ファイルをインポートします。
このページにある CSV ファイルの例 は、ファイルの表形式配置を説明しています。 さらに、以下の画像は調査ページからの 結果をエクスポート 方法を示しています。
CSV ファイルをインポートしてカスタムフィールドを更新する
また、Nexthink のワークフロー実行で カスタムフィールドの更新 Thinklet を使用して手動カスタムフィールド値を更新できます。
カスタムフィールド ページから：
ページ右上のアクションメニューをクリックします。
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。ファイルには少なくとも一つの 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
権限
カスタムフィールドの適切な権限を有効にするには：
メインメニューから 管理 を選択します。
ナビゲーション パネルから ロール をクリックします。
ページ右上にある 新しいロール ボタンをクリックして、新しいロールを作成します。
または、編集アイコンをクリックして既存のロールを編集し、ロールを設定します。
権限 セクションで、 管理 にスクロールダウンし、 全カスタムフィールドを管理 を有効にします。 これにより、ユーザーはカスタムフィールドの作成、編集、削除、および手動カスタムフィールドの値の設定が可能になります。 この権限は、フルビュードメイン を持つユーザーのみが利用可能です。
全カスタムフィールドを管理 権限を持った人には、全評価を管理 権限が自動的に付与されます（ルールベースのカスタムフィールドを設定するためのユーザー権限を付与）。
それ以外の場合、手動カスタムフィールドの編集 権限をもったユーザーは、制限ビュー ドメイン での利用が認められます。
この権限は、 全カスタムフィールドを管理 権限を持つユーザーに自動的に付与されます。
権限オプションの詳細な説明については、 ロール のドキュメントを参照してください。
Last updated
Was this helpful?