New Relicユーザーとして、複数のダッシュボードで複雑なNRQLクエリを繰り返し記述することがあるかもしれません。毎回複数行のクエリを記憶して書き直すことは、時間がかかり、エラーが発生しやすくなります。データが変更され、クエリを調整する必要がある場合、組織全体でそのクエリの各インスタンスを手動で更新しなければならず、メンテナンス上の大きな負担となります。
NRQLマクロは、NRQL式を再利用可能な名前付きショートカットとして保存できるようにすることで、この問題を解決します。クエリ内でマクロを参照するには、$記号の後にその名前を続けます（たとえば$prod_filter）。クエリが実行される前に、New Relicが保存された式に置き換えます。クエリビルダーとダッシュボードでマクロを使用できます。
マクロを使ってできること
NRQLマクロを使用して、次のことができます：
- 再利用可能な式の作成：NRQLクエリの式を分かりやすい名前のマクロに変換することで、毎回完全な式を再入力したり覚えたりする必要がなくなります。
- アカウント間で式を再利用する：マクロは組織レベルのエンティティです。組織内のどのアカウントでも、マクロを再定義することなく使用できます。また、適切なロールを持つすべてのユーザーは、組織内で作成されたすべてのマクロにアクセスして使用できます。
- クエリを一元的に更新: マクロを編集すると、そのマクロを使用しているすべてのクエリに変更が自動的に反映されるため、各クエリを検索して個別に更新する必要はありません。
前提条件
NRQLマクロを使用するには、以下が必要です：
- アカウント・アクセス：マクロを使用する組織内のアカウントへのアクセス。マクロは組織レベルのエンティティであるため、一度作成すると、組織内のすべてのアカウントで利用できます。
- NRQLの知識：マクロの式はNRQL式であるため、NRQL構文の基本的な知識が必要です。
マクロの権限
マクロを作成または使用する前に、権限の仕組みや、誰がマクロにアクセスできるかを理解することが重要です。
組織協会
すべてのマクロは、作成された組織に属するリソースです。この関連付けは永続的であり、変更できません。マクロを異なる組織間で共有することはできません。組織が削除されると、マクロも削除されます。ユーザーが別の組織に移動した場合、以前の組織のマクロにはアクセスできなくなります。
現在の権限モデル
New Relicのマクロは、アクセスを制御するためにCRUD機能を持つ組み込みロールを使用します。マクロへのアクセスは組織レベルのみであり、管理者によって設定されます。
組織レベルの権限
これらは、New Relic管理UIのデフォルトのシステムロールによって付与されます。
ロール | 機能 | 許可される操作 |
|---|---|---|
Organization product admin または Organization manager |
| 組織内の任意のマクロの作成、読み出し、更新、削除 |
Organization read only |
| 組織内の任意のマクロの読み取り |
次のステップ
マクロの作成、使用、管理については、「マクロの作成と管理」を参照してください。