New Relicサービスレベルアクション

このページでは、ワークフロー自動化アクションカタログで利用可能なすべてのNew Relic サービスレベルアクションのリファレンスを提供します。これらのアクションにより、ワークフローから直接サービスレベル指標（SLI）とそのサービスレベル目標（SLO）を作成、更新、削除、および列挙できます — これにより、自動化されたサービスのオンボーディング、SLOの修復、およびコンプライアンスワークフローが可能になります。

前提条件

ワークフローの自動化でNew Relicサービスレベルのアクションを使用する前に、以下のものがあることを確認してください：

サービスレベルを管理するための適切な権限を持つNew Relicアカウント。

サービスレベルを作成します

アクション識別子はnewrelic.serviceLevel.createです。

エンティティの新しいサービスレベル指標（SLI）とサービスレベル目標（SLO）を作成します。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
entityGuid	弦	必須。このSLIが定義されているエンティティ。	`"MjXzMzQ2fEFQTXxBUFBMSUNBVElPTnwyMzU5MzAzOTU"`
name	弦	必須。 SLI名。	`"Checkout API availability"`
description	弦	オプション。 SLIの説明。	`"Auto-provisioned on service onboarding"`
アカウントID	Int	必須。 SLIを所有するNew Relicアカウントです。	`1234567`
validEventsFrom	弦	必須。有効なイベントプールのNRDBイベントタイプです。	`"Transaction"`
validEventsWhere	弦	オプション。有効なイベントプールをフィルタリングするNRQLブール条件。	`"appName = 'checkout-api'"`
validEventsSelectFunction	弦	オプション。有効なイベントプールの集約関数。 `COUNT` 、 `SUM` 、 `GET_FIELD` 、 `GET_CDF_COUNT` のいずれか。	`"COUNT"`
validEventsSelectAttribute	弦	オプション。有効なイベントプールで集計する属性。 `validEventsSelectFunction` が `SUM` 、 `GET_FIELD` 、または `GET_CDF_COUNT` の場合に必須です。	`"duration"`
validEventsSelectThreshold	浮く	オプション。有効なイベントプールの閾値。 `validEventsSelectFunction` が `GET_CDF_COUNT` の場合にのみ使用されます。	`500`
eventCategory	弦	必須。条件イベントバケットの、良いイベントまたは悪いイベントとしての分類。 `GOOD` 、 `BAD` のいずれか。	`"GOOD"`
conditionEventsFrom	弦	必須。良い/悪いイベントバケットのNRDBイベントタイプ。	`"Transaction"`
conditionEventsWhere	弦	オプション。良い/悪いイベントのバケットをフィルタリングするためのNRQLブール条件。	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	弦	オプション。良い/悪いイベントのバケットの集計関数。 `COUNT` 、 `SUM` 、 `GET_FIELD` 、 `GET_CDF_COUNT` のいずれか。	`"COUNT"`
conditionEventsSelectAttribute	弦	オプション。 good/badバケット用に集計する属性。 `conditionEventsSelectFunction` が `SUM` 、 `GET_FIELD` 、または `GET_CDF_COUNT` の場合に必須です。	`"duration"`
conditionEventsSelectThreshold	浮く	オプション。良い/悪いバケットの閾値。 `conditionEventsSelectFunction` が `GET_CDF_COUNT` の場合にのみ使用されます。	`500`
ファセット	リスト	オプション。 SLI結果をグループ化するための属性です。	`["appName"]`
ターゲット	浮く	必須。 SLOターゲット（パーセント）。	`99.9`
windowDays	Int	必須。日単位のローリングウィンドウ。 `1` 、 `7` 、または `28` である必要があります。	`28`
selectors	リスト	オプション。レスポンスから特定の値を抽出するためのJQセレクター。後続のステップで使用するために、 `.data.serviceLevelCreate.guid` を使用して新しいSLIのGUIDをキャプチャします。	`selectors: - name: sliGuid expression: ".data.serviceLevelCreate.guid"`

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` / `false` 、基盤となる `newrelic.nerdgraph.execute` 呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。
errorMessage	弦	トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "serviceLevelCreate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` `selectors`を使用して、`data`から`guid`または`name`を抽出します。

出力

タイプ

説明

success

ブール値

true

false

、基盤となる

newrelic.nerdgraph.execute

呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。

errorMessage

弦

トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "serviceLevelCreate": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability"
    }
  }
}

selectorsを使用して、dataからguidまたはnameを抽出します。

次の例では、SLI/SLOを作成し、後続のステップで使用するためにselectorsを使用して新しいSLIのGUIDをキャプチャします。

ワークフローの例
name: newrelic_service_level_create_workflow description: Create an SLI/SLO for a service entity steps: - name: createSlo type: action action: newrelic.serviceLevel.create version: 1 inputs: entityGuid: ${{ .workflowInputs.entityGuid }} name: "Checkout API availability" accountId: ${{ .workflowInputs.accountId }} validEventsFrom: "Transaction" eventCategory: "GOOD" conditionEventsFrom: "Transaction" conditionEventsWhere: "appName = 'checkout-api' AND error IS FALSE" target: 99.9 windowDays: 28 selectors: - name: sliGuid expression: ".data.serviceLevelCreate.guid" next: end

ワークフローの例

name: newrelic_service_level_create_workflow
description: Create an SLI/SLO for a service entity
steps:
  - name: createSlo
    type: action
    action: newrelic.serviceLevel.create
    version: 1
    inputs:
      entityGuid: ${{ .workflowInputs.entityGuid }}
      name: "Checkout API availability"
      accountId: ${{ .workflowInputs.accountId }}
      validEventsFrom: "Transaction"
      eventCategory: "GOOD"
      conditionEventsFrom: "Transaction"
      conditionEventsWhere: "appName = 'checkout-api' AND error IS FALSE"
      target: 99.9
      windowDays: 28
      selectors:
        - name: sliGuid
          expression: ".data.serviceLevelCreate.guid"
    next: end

サービスレベルを更新

アクション識別子はnewrelic.serviceLevel.updateです。

既存のサービスレベルインジケーターの設定、またはそのサービスレベル目標を更新します。newrelic.nerdgraph.executeを使用します。

フィールドnameとdescriptionは個別にオプションです — どちらかを省略すると既存の値が保持されます。フィールドtargetとwindowDaysは両方指定するか両方省略するかのどちらかです：SLOターゲットを変更するには両方を指定し、既存のSLOを変更しないようにするには両方を省略します。

イベント設定（validEvents*、conditionEvents*、eventCategory、facets）では、フィールドを省略すると、保持されるのではなく削除されます。イベントセクションの1つのフィールドを変更するには、変更内容とともに現在のイベント定義全体を再指定してください。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
sliGuid	弦	必須。 SLIのGUIDです。 `newrelic.serviceLevel.create` からの `sliGuid` セレクター出力を使用します。	`"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"`
name	弦	オプション。新しいSLI名。省略すると、既存の名前が保持されます。	`"Checkout API availability (v2)"`
description	弦	オプション。新しいSLIの説明。省略すると、既存の説明が保持されます。	`"Tightened after Q3 reliability review"`
validEventsFrom	弦	オプション。有効なイベントプールのNRDBイベントタイプ。他の `validEvents` 、 `conditionEvents` 、または `eventCategory` フィールドのいずれかが設定されている場合は必須です。	`"Transaction"`
validEventsWhere	弦	オプション。有効なイベントプールをフィルタリングするNRQLブール条件。	`"appName = 'checkout-api'"`
validEventsSelectFunction	弦	オプション。有効なイベントプールの集約関数。 `COUNT` 、 `SUM` 、 `GET_FIELD` 、 `GET_CDF_COUNT` のいずれか。	`"COUNT"`
validEventsSelectAttribute	弦	オプション。有効なイベントプールで集計する属性。 `validEventsSelectFunction` が `SUM` 、 `GET_FIELD` 、または `GET_CDF_COUNT` の場合に必須です。	`"duration"`
validEventsSelectThreshold	浮く	オプション。有効なイベントプールの閾値。 `validEventsSelectFunction` が `GET_CDF_COUNT` の場合にのみ使用されます。	`500`
eventCategory	弦	オプション。条件イベントバケットの良いイベントまたは悪いイベントとしての分類。 `GOOD` 、 `BAD` のいずれか。イベント設定を行う場合、 `conditionEventsFrom` と一緒に指定する必要があります。	`"GOOD"`
conditionEventsFrom	弦	オプション。良い/悪いイベントバケットのNRDBイベントタイプ。	`"Transaction"`
conditionEventsWhere	弦	オプション。良い/悪いイベントのバケットをフィルタリングするためのNRQLブール条件。	`"appName = 'checkout-api' AND error IS FALSE"`
conditionEventsSelectFunction	弦	オプション。良い/悪いイベントのバケットの集計関数。 `COUNT` 、 `SUM` 、 `GET_FIELD` 、 `GET_CDF_COUNT` のいずれか。	`"COUNT"`
conditionEventsSelectAttribute	弦	オプション。 good/badバケット用に集計する属性。 `conditionEventsSelectFunction` が `SUM` 、 `GET_FIELD` 、または `GET_CDF_COUNT` の場合に必須です。	`"duration"`
conditionEventsSelectThreshold	浮く	オプション。良い/悪いバケットの閾値。 `conditionEventsSelectFunction` が `GET_CDF_COUNT` の場合にのみ使用されます。	`500`
ファセット	リスト	オプション。 SLI結果をグループ化するための属性です。	`["appName"]`
ターゲット	浮く	オプション。新しいSLOターゲット（パーセント）。 `windowDays` とのオールオアナッシング：両方を一緒に指定するか、両方を省略します。	`99.95`
windowDays	Int	オプション。日単位のローリングウィンドウ。設定する場合は、 `1` 、 `7` 、または `28` である必要があります。 `target` とのAll-or-nothing：両方を一緒に指定するか、両方を省略します。	`28`
selectors	リスト	オプション。レスポンスから特定の値を抽出するためのJQセレクター。	`selectors: - name: sliGuid expression: ".data.serviceLevelUpdate.guid"`

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` / `false` 、基盤となる `newrelic.nerdgraph.execute` 呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。
errorMessage	弦	トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "serviceLevelUpdate": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability (v2)" } } }` `selectors`を使用して、`data`から`guid`または`name`を抽出します。

出力

タイプ

説明

success

ブール値

true

false

、基盤となる

newrelic.nerdgraph.execute

呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。

errorMessage

弦

トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "serviceLevelUpdate": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability (v2)"
    }
  }
}

selectorsを使用して、dataからguidまたはnameを抽出します。

次の例では、前のnewrelic.serviceLevel.createステップでキャプチャしたGUIDを使用して、既存のSLIのSLOターゲットを厳格化します。

ワークフローの例
`name: newrelic_service_level_update_workflow description: Tighten the SLO target on an existing SLI steps: - name: tightenSlo type: action action: newrelic.serviceLevel.update version: 1 inputs: sliGuid: ${{ .steps.createSlo.outputs.sliGuid }} target: 99.95 windowDays: 28 next: end`

ワークフローの例

name: newrelic_service_level_update_workflow
description: Tighten the SLO target on an existing SLI
steps:
  - name: tightenSlo
    type: action
    action: newrelic.serviceLevel.update
    version: 1
    inputs:
      sliGuid: ${{ .steps.createSlo.outputs.sliGuid }}
      target: 99.95
      windowDays: 28
    next: end

サービスレベルを削除

アクション識別子はnewrelic.serviceLevel.deleteです。

既存のサービスレベルインジケーター（SLI）とそのサービスレベル目標（SLO）を削除します。newrelic.nerdgraph.executeを使用します。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力

タイプ

説明

例

sliGuid

弦

必須。

SLIのGUIDです。

newrelic.serviceLevel.create

からの

sliGuid

セレクター出力を使用します。

"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"

selectors

リスト

オプション。

レスポンスから特定の値を抽出するためのJQセレクター。

selectors:
  - name: deletedGuid
    expression: ".data.serviceLevelDelete.guid"

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` / `false` 、基盤となる `newrelic.nerdgraph.execute` 呼び出しから継承されます — トランスポート障害（200以外、ネットワークエラー）とNerdGraphのビジネスロジックエラー（200応答内の `errors` 配列）の両方をカバーします。
errorMessage	弦	トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "serviceLevelDelete": { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } } }` `selectors`を使用して、`data`から`guid`または`name`を抽出します。

出力

タイプ

説明

success

ブール値

true

false

、基盤となる

newrelic.nerdgraph.execute

呼び出しから継承されます — トランスポート障害（200以外、ネットワークエラー）とNerdGraphのビジネスロジックエラー（200応答内の

errors

配列）の両方をカバーします。

errorMessage

弦

トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "serviceLevelDelete": {
      "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
      "name": "Checkout API availability"
    }
  }
}

selectorsを使用して、dataからguidまたはnameを抽出します。

次の例では、ワークフローの入力として渡されたGUIDを使用してSLIを削除します。

ワークフローの例
`name: newrelic_service_level_delete_workflow description: Delete an existing SLI/SLO steps: - name: retireSlo type: action action: newrelic.serviceLevel.delete version: 1 inputs: sliGuid: ${{ .workflowInputs.sliGuid }} next: end`

ワークフローの例

name: newrelic_service_level_delete_workflow
description: Delete an existing SLI/SLO
steps:
  - name: retireSlo
    type: action
    action: newrelic.serviceLevel.delete
    version: 1
    inputs:
      sliGuid: ${{ .workflowInputs.sliGuid }}
    next: end

サービスレベルの列挙

アクション識別子はnewrelic.serviceLevel.listです。

オプションでアカウントまたはコンプライアンスステータスにスコープ設定された、サービスレベルインジケーターエンティティを一覧表示します。newrelic.nerdgraph.executeを使用します。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
アカウントID	Int	オプション。結果を1つのNew Relicアカウントに絞り込みます。省略すると、リクエスタがアクセスできるすべてのアカウントのSLIが返されます。	`11933347`
onlyNonCompliant	ブール値	オプション。コンプライアンスステータスフィルター。 `true` の場合、結果を `Non-compliant` または `At risk` のタグが付けられたSLIに制限します — サービスレベル管理UIの「Show only at risk and non-compliant」トグルと同等です。 `false` とこのフィールドの省略はどちらも、コンプライアンスステータスに関係なくすべてのSLIを返します。	`true`
フィルター	弦	オプション。クエリに付加される追加の生の `entitySearch` フィルター句。	`"name LIKE '%checkout%'"`
リミット	Int	オプション。結果のページサイズ。	`50`
カーソル	弦	オプション。以前の呼び出しの `nextCursor` 出力からのページネーショントークン。初回の呼び出しでは空白のままにします。	`"oWUNlXQ65ke3hEVGplVS1UOWJFRstmVTZFMVhj..."`
selectors	リスト	オプション。レスポンスから特定の値を抽出するためのJQセレクター。SLIリストを取得するには `.data.actor.entitySearch.results.entities` を使用し、ページネーショントークンには `.data.actor.entitySearch.results.nextCursor` を使用します。	`selectors: - name: entities expression: ".data.actor.entitySearch.results.entities" - name: nextCursor expression: ".data.actor.entitySearch.results.nextCursor"`

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
success	ブール値	`true` / `false` 、基盤となる `newrelic.nerdgraph.execute` 呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。
errorMessage	弦	トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は `null` 。
データ	地図	生のNerdGraphレスポンス。`data`から`entities`、`count`、または`nextCursor`を抽出するには、`selectors`を使用します。これ以上ページがない場合、`nextCursor`は`null`になります。 `{ "data": { "actor": { "entitySearch": { "count": 2, "results": { "entities": [ { "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE", "name": "Checkout API availability" } ], "nextCursor": null } } } } }`

出力

タイプ

説明

success

ブール値

true

false

、基盤となる

newrelic.nerdgraph.execute

呼び出しから継承 — トランスポートの失敗とNerdGraphのビジネスロジックエラーの両方をカバーします。

errorMessage

弦

トランスポートレベルのエラーかNerdGraphのビジネスロジックエラーかにかかわらず、失敗時のエラーメッセージ。成功した場合は

null

。

データ

地図

生のNerdGraphレスポンス。dataからentities、count、またはnextCursorを抽出するには、selectorsを使用します。これ以上ページがない場合、nextCursorはnullになります。

{
  "data": {
    "actor": {
      "entitySearch": {
        "count": 2,
        "results": {
          "entities": [
            {
              "guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
              "name": "Checkout API availability"
            }
          ],
          "nextCursor": null
        }
      }
    }
  }
}

次の例では、アカウントのすべての非準拠SLIをリストし、selectorsを使用してエンティティリストを抽出します。

ワークフローの例
`name: newrelic_service_level_list_workflow description: List non-compliant SLIs for an account steps: - name: findNonCompliantSlis type: action action: newrelic.serviceLevel.list version: 1 inputs: accountId: ${{ .workflowInputs.accountId }} onlyNonCompliant: true limit: 50 selectors: - name: entities expression: ".data.actor.entitySearch.results.entities" next: end`

ワークフローの例

name: newrelic_service_level_list_workflow
description: List non-compliant SLIs for an account
steps:
  - name: findNonCompliantSlis
    type: action
    action: newrelic.serviceLevel.list
    version: 1
    inputs:
      accountId: ${{ .workflowInputs.accountId }}
      onlyNonCompliant: true
      limit: 50
      selectors:
        - name: entities
          expression: ".data.actor.entitySearch.results.entities"
    next: end

この機械翻訳は、参考として提供されています。

New Relicサービスレベルアクション

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

サービスレベルを作成します

サービスレベルを更新

サービスレベルを削除

サービスレベルの列挙

前提条件