はじめに

New Relicのクエリ言語NRQLの2024年1月のアップデートで、JSONを柔軟に解析できる新しい関数が登場しました！この記事ではそれぞれの関数の使い方を紹介します！

このアップデートの詳細はこちら
What's new
その他アップデートの詳細はこちら
New Relic アップデート(2024年1月)
New Relic アップデート一覧

新関数の使い方を確認

今回、登場した関数は以下になります。

関数名	機能内容
jparse()	JSONを解析し、値のマップ/リスト（またはネストされた構造）を生成します
mapKeys()	解析されたJSONからキーを返します
mapValues()	解析されたJSONから値を返します

各関数の使い方を見ていきます！

jparse()

jparse() は、文字列値を受け取り、値のマップまたはリスト (またはネストされた構造) を生成します。

例えば、下記のクエリでは、指定されたJSONデータから ID、名前、および特定の値を抽出します。

WITH '{"users": [{"name": "Hello", "id": 435}, {"name": "World", "id": 436}, {"name": "GetThisName", "id": 500}]}' as jsonString, 
     jparse(jsonString, 'users[*].id') as ids, 
     jparse(jsonString, 'users[*].name') as names, 
     jparse(jsonString, 'users[2].name') as getSpecificValue
SELECT ids, names, getSpecificValue

aparse() を使って、ログのmessageからJSONデータを抽出し、jparse()で特定の値を抽出してみます。

WITH '1693242121842: value=\'{"user": {"name": "John", "id": 5}}\', useless=stuff' as logMessage,
       aparse(logMessage, '%: value=\'*\'%') AS jsonString
SELECT jparse(jsonString, 'user.name') AS Name

mapKeys()

mapKeys()は、マップが渡されると、すべてのキーのリストを抽出します。

WITH '{"Field1": "exampleString", "Field2": false, "Field3": 100}' AS jsonString 
SELECT mapKeys(jparse(jsonString)) AS keys

ネストされたキーを含むJSONデータからキーのリストを抽出します。

WITH '{"value1": "test", "value2": {"nestedValue1": [1, 2, 3], "nestedValue2": 100}}' as jsonString
SELECT mapKeys(jparse(jsonString)) AS keys

mapValues()

mapValues() は、マップが入力として渡されると、すべての値のリストを抽出します。

WITH '{"Field1": "exampleString", "Field2": false, "Field3": 100}' AS jsonString 
SELECT mapKeys(jparse(jsonString)) as values

ネストされたキーを含むJSONデータから値のリストを抽出します。

WITH '{"value1": "test", "value2": {"nestedValue1": [1, 2, 3], "nestedValue2": 100}}' as jsonString
SELECT mapValues(jparse(jsonString)) AS values

まとめ

今回、２０２４年１月の機能アップデートで登場したjparse() 、mapKeys() 、mapValues()のNQRLクエリ関数の使い方を紹介させていただきました。ログに含まれるJSONから必要なデータを簡単に抽出して、ダッシュボードで分析したり、アラート条件に指定するなどできますのでご活用ください！！