From 9eec21413f1695859ef711580a97c1f0c69d4ae8 Mon Sep 17 00:00:00 2001 From: Sammie downing Date: Tue, 16 Apr 2024 15:06:26 -0700 Subject: [PATCH] fix(alerts): deleting i18n docs --- ...y-detector-configurations-api-tutorial.mdx | 519 ----------------- ...y-detector-configurations-api-tutorial.mdx | 519 ----------------- ...y-detector-configurations-api-tutorial.mdx | 528 ------------------ 3 files changed, 1566 deletions(-) delete mode 100644 src/i18n/content/jp/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx delete mode 100644 src/i18n/content/kr/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx delete mode 100644 src/i18n/content/pt/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx diff --git a/src/i18n/content/jp/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx b/src/i18n/content/jp/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx deleted file mode 100644 index 6624f18ffbe..00000000000 --- a/src/i18n/content/jp/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx +++ /dev/null @@ -1,519 +0,0 @@ ---- -title: NerdGraphチュートリアル。異常検知の設定 -tags: - - APIs - - NerdGraph -metaDescription: How to use New Relic NerdGraph API to query and update anomaly detector configurations. -freshnessValidatedDate: never -translationType: machine ---- - -New Relic の自動異常検知は、異常検知器から始まります。異常検知器とは、特定のデータセットの異常を体系的に観察し、記録する方法です。データセットに名前を付けて設定するには、異常検出器の設定を作成する必要があります。これは、監視対象のシグナルや異常データをどこに保存するかを示すフィールドのセットです。 - - - この機能はまだプレビュー段階ですが、ぜひお試しください。 - - -設定には、監視するデータセットの作成方法の違いに対応する3つの種類があります。ワークロード構成では、 [ワークロード](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) に含まれるすべてのエンティティをデータセットとして使用して検出器を作成します。エンティティタイプ構成では、1つまたは複数のアカウントの単一の [エンティティタイプ](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) (たとえば、モバイルアプリ)のすべてのエンティティをデータセットとして使用します。NRQL構成では、1つ以上の [NRQLクエリ](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) の結果をデータセットとして使用します。 - -異常検知器の設定は、 [NerdGraph API](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) で管理することができます。これには、 [api.newrelic.com/graphiql](https://api.newrelic.com/graphiql) にある GraphiQL インターフェースの使用も含まれます。 - -ここではいくつかの例をご紹介します。 - -* [コンフィギュレーションの作成](#create-configuration) -* [設定の更新](#update-configuration) -* [設定の削除](#delete-configuration) -* [設定の照会](#query-configurations) -* [デフォルトのしきい値の照会](#query-thresholds) - -## コンフィギュレーションの作成 [#create-configuration] - -以下は、既存の [ワークロード](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) を使用して構成を作成する NerdGraph [突然変異](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph#terminology) の例です。 - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorCreate( - workloadGuid: "WORKLOAD_GUID", - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...] - } - ) - { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `workloadGuid`: データセットの定義に使用される[ワークロード GUID](/docs/new-relic-one/use-new-relic-one/core-concepts/new-relic-one-workloads-isolate-resolve-incidents-faster#workload-account) 。異常は、このワークロード内のすべてのエンティティ ( `excludedEntityGuids`で指定されていない限り) からのゴールデン シグナルに基づいて検出されます。異常なデータは、このワークロードに関連付けられたアカウントに保存されます。ワークロードは後で編集できません。 -* `anomalyDetector.name`: 構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.excludedEntityGuids`: オプション。このフィールドを使用すると、一部のエンティティをワークロードから削除せずにデータセットから除外できます。これは、異常検出に使用する既存のワークロードがある場合に役立ちます。 - -以下は、 [エンティティタイプ](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) を使用して構成を作成するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `accountId`: 異常なデータを保存し、データセットのエンティティを決定するために使用される accountId。このアカウントは後で編集できません。 -* `anomalyDetector.name`: 構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.domainType`： -* `domain`: エンティティ ドメインを表す文字列。 -* `type`: エンティティ タイプを表す文字列。 -* `anomalyDetector.includedEntityGuids`: オプション。このフィールドを使用すると、アカウントからすべてのエンティティを追加せずに、データセットに一部のエンティティを含めることができます。これは、異常検出に使用したい同じタイプのエンティティが少数しかない場合、または静的データセットが必要な場合に役立ちます。デフォルトでは、エンティティ タイプ内のすべてのエンティティが使用されますが、時間の経過とともに変更される可能性があります。 -* `anomalyDetector.additionalSourceAccountIds`: オプション。このフィールドを使用すると、複数のアカウントのエンティティをデータセットに含めることができます。これらのアカウントは後で編集できます。 - -以下は、 [NRQL クエリの結果を使用して構成を作成するミューテーションの例です。](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/): - - - すべてのNRQL機能が異常検知に対応しているわけではありません。無効なNRQLのエラーを避けるために、まずシグナルのNRQLを [検証変異](#validate-nrql) に通してください。 - - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - nrqlSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ] - } - ) - { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `accountId`: 異常なデータを保存するために使用される accountId。このアカウントは後で編集できます。 -* `anomalyDetector.name`: 構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.nrqlSignals`: カスタム NRQL クエリによって定義されたシグナルのリスト。 -* `accountId`: 照会されている accountId。 -* `name`: シグナルを説明するわかりやすい名前の文字列。例: 「Throughput」、「ErrorRate」など。 -* `nrql`: [NRQL クエリ](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/)。異常検出は現在、すべての NRQL 機能をサポートしているわけではありません。構成を作成する前に、[検証ミュー](#validate-nrql)テーションを使用して、NRQL クエリが完全にサポートされていることを確認できます。 -* `mutedFacetValues`: オプション。このフィールドを使用すると、結果のデータセットから一部のファセット値を除外できます。 - -## 設定の更新 [#update-configuration] - -以下は、 [ワークロード](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) の構成を更新するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `anomalyDetectorId`: 検出器の一意の識別子。 -* `anomalyDetector.name`: オプション。構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.status`: オプション。ステータスのデフォルトは`ACTIVE`です。検出器が異常を生成しないようにする場合は、このフィールドを`INACTIVE`に設定できます。 -* `anomalyDetector.deviationSensitivity`: オプション。どのデータが異常であるかを判断するための機密レベル。このフィールドのデフォルトは`LOW`で、最も重大な異常のみが記録されます。より機密性が必要な場合は、このフィールドを`MEDIUM`または`HIGH`に設定できます。 -* `anomalyDetector.excludedEntityGuids`: オプション。このフィールドを使用すると、一部のエンティティをワークロードから削除せずにデータセットから除外できます。これは、異常検出に使用する既存のワークロードがある場合に役立ちます。既存の excludeEntityGuids をクリアしたい場合は、空の配列`[]`を渡します。 -* `anomalyDetector.thresholds`: オプション。詳細については、[しきい値](#update-thresholds)に関するセクションを参照してください。 - -以下は、 [エンティティタイプ](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) の設定を更新するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `anomalyDetectorId`: 検出器の一意の識別子。 -* `anomalyDetector.name`: オプション。構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.status`: オプション。ステータスのデフォルトは`ACTIVE`です。検出器が異常を生成しないようにする場合は、このフィールドを`INACTIVE`に設定できます。 -* `anomalyDetector.deviationSensitivity`: オプション。どのデータが異常であるかを判断するための機密レベル。このフィールドのデフォルトは`LOW`で、最も重大な異常のみが記録されます。より機密性が必要な場合は、このフィールドを`MEDIUM`または`HIGH`に設定できます。 -* `anomalyDetector.includedEntityGuids`: オプション。このフィールドを使用すると、アカウントからすべてを追加するのではなく、エンティティ タイプからいくつかのエンティティを含めることができます。これは、異常検出に使用したい同じタイプのエンティティが少数しかない場合に便利です。タイプ内のすべてのエンティティを使用する場合は、空の配列`[]`を渡します。 -* `anomalyDetector.additionalSourceAccountIds`: オプション。このフィールドを使用すると、複数のアカウントのエンティティをデータセットに含めることができます。 -* `anomalyDetector.thresholds`: オプション。詳細については、[しきい値](#update-thresholds)に関するセクションを参照してください。 - -以下は、 [NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) の設定を更新するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "UPDATED_CONFIGURATION_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - newSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ], - updatedSignals: [ - { - queryId: QUERY_ID, - name: "UPDATED_NAME_OF_NRQL_SIGNAL", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...], - threshold: THRESHOLD - } - ], - deletedQueries: [QUERY_ID_1, QUERY_ID_2] - } - ) - { - anomalyDetectorId - } -} -``` - -この突然変異の詳細については - -* `anomalyDetectorId`: 検出器の一意の識別子。 -* `accountId`: オプション。異常なデータを保存するために使用される accountId。 -* `anomalyDetector.name`: オプション。構成を説明するわかりやすい名前の文字列。 -* `anomalyDetector.status`: オプション。ステータスのデフォルトは`ACTIVE`です。検出器が異常を生成しないようにする場合は、このフィールドを`INACTIVE`に設定できます。 -* `anomalyDetector.deviationSensitivity`: オプション。どのデータが異常であるかを判断するための機密レベル。このフィールドのデフォルトは`LOW`で、最も重大な異常のみが記録されます。より機密性が必要な場合は、このフィールドを`MEDIUM`または`HIGH`に設定できます。 -* `anomalyDetector.newSignals`: オプション。検出器に追加するシグナルのリスト。 -* `accountId`: 照会されている accountId。 -* `name`: シグナルを説明するわかりやすい名前の文字列。例: 「Throughput」、「ErrorRate」など。 -* `nrql`: [NRQL クエリ](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/)。異常検出は現在、すべての NRQL 機能をサポートしているわけではありません。構成を作成する前に、[検証ミュー](#validate-nrql)テーションを使用して、NRQL クエリが完全にサポートされていることを確認できます。 -* `mutedFacetValues`: オプション。このフィールドを使用すると、結果のデータセットから一部のファセット値を除外できます。 -* `anomalyDetector.updatedSignals`: オプション。変更のあるシグナルのリスト。 -* `queryId`: 一意のシグナル クエリ識別子。 -* `name`: オプション。シグナルを説明するわかりやすい名前の文字列。例: 「Throughput」、「ErrorRate」など。 -* `mutedFacetValues`: オプション。このフィールドを使用すると、結果のデータセットから一部のファセット値を除外できます。 -* `threshold`: オプション。詳細については、[しきい値](#update-thresholds)に関するセクションを参照してください。 -* `anomalyDetector.deletedQueries`: オプション。検出器から削除する一意のシグナル クエリ識別子のリスト。 - -## 設定の削除 [#delete-configuration] - -以下は、あらゆる種類の設定を削除するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsAnomalyDetectorDelete( - anomalyDetectorId: DETECTOR_ID - ) - { - success - } -} -``` - -この突然変異の詳細については - -* `anomalyDetectorId`: 検出器の一意の識別子。 - -## アノマリーディテクターの設定を問い合わせる [#query-configurations] - -以下は、自分がアクセスできるすべての設定を返すミューテーションの例です。 - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - ... on AnomalyDetectorConfigurationsWorkloadAnomalyDetector { - workloadGuid { - guid - } - } - ... on AnomalyDetectorConfigurationsEntityTypeAnomalyDetector { - domainType { - domain - type - } - } - ... on AnomalyDetectorConfigurationsNrqlAnomalyDetector { - nrqlSignals { - name - } - } - } - } - } -} -``` - -簡略化されたクエリは、すべてのタイプの構成でアクセス可能なフィールドに興味がある場合に使用できます。 - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - } - } - } -} -``` - -特定の設定を取得したい場合は、以下のように固有の識別子を含むフィルターを前のクエリに渡します。 - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors(filters: {anomalyDetectorIds: [ANOMALY_DETECTOR_ID_1, ANOMALY_DETECTOR_ID_2, ...]}) { - id - name - } - } - } -} - -``` - -この質問の一部について詳細を説明します。 - -* `filters`: オプション。 -* `filters.anomalyDetectorIds`: オプション。一意の異常検出器識別子のリスト。 - -[QraphiQL explorer](https://api.newrelic.com/graphiql) で、より多くのクエリ可能なフィールドを見ることができます。 - -## デフォルトのしきい値の照会 [#query-thresholds] - -以下は、現在のデフォルトの [スレッショルドを返すクエリの例です](#query-thresholds) 。 - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds { - signalName - domainType { - domain - type - } - deviationSensitivity - upperLimit { - active - value - } - upperRelativePercent { - active - value - } - significantDeviationDirection - lowerRelativePercent { - value - active - } - lowerLimit { - active - value - } - } - } - } -} -``` - -このクエリについての詳細です。 - -* **signalName**: **globalDefault** という名前のグローバルな閾値か、信号の閾値を表す文字列（例えば、"throughput," " errorRate," など）。 -* **domainType**: グローバル閾値にはドメインタイプがありません。 - -しきい値を1つ以上のdomainTypesにフィルタリングしたい場合は、前のクエリに次のようにフィルタを渡します。 - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds(filters: { - domainTypes: [ - { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - } - ] - } - ) - { - signalName - } - } - } -} -``` - -この質問の一部について詳細を説明します。 - -* `domainType.domain`: エンティティ ドメインを表す文字列。 -* `domainType.type`: エンティティ タイプを表す文字列。 - -## カスタムNRQLシグナルの検証 [#validate-nrql] - -これは、NRQL ベースの異常検知器を作成する場合にのみ有効です。異常検知はすべてのNRQL機能をサポートしているわけではありません。作成時のエラーを回避するために、まず使用予定のNRQLクエリを検証してください。クエリが有効でない場合は、その理由のリストを提供します。空のリストは、あなたのクエリが有効であることを示します。 - -以下は、NRQL クエリが異常検知に完全に対応していることを検証するミューテーションの例です。 - -``` -mutation { - anomalyDetectorConfigurationsValidateNrqlSignal( - accountId: ACCOUNT_ID, - nrql: "NRQL" - ) { - invalidNrqlReasons - } -} -``` - -この突然変異の詳細については - -* `accountId`: 照会されている accountId。 -* `nrql`: [NRQL クエリ](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/)。 - -理由は、あなたのクエリが無効である可能性があります。 - -* `CASES_NOT_SUPPORTED` - ケースはサポートされていません。 -* `COMPARE_WITH_NOT_SUPPORTED` - COMPARE WITH 句はサポートされていません。 -* `COULDNT_COMPLETE_QUERY` - クエリが返したデータが多すぎて、異常検出をサポートできませんでした。 -* `DAQS_NOT_ALLOWED` - クエリは DAQS ではサポートされていません。 -* `INVALID_NRQL` - クエリが無効です。 -* `LIMIT_NOT_SUPPORTED` - LIMIT 句はサポートされていません。 -* `MISSING_FACET` - クエリにファセット値がありません。 -* `MULTIPLE_FACET_NOT_SUPPORTED` - クエリごとの複数のファセット属性はサポートされていません。 -* `MULTISELECT_NOT_SUPPORTED` - 複数の SELECT 句はサポートされていません。 -* `NON_NUMERIC_AGGREGATE_NOT_SUPPORTED` - 非数値を返すクエリはサポートされていません。 -* `NOT_AUTHORIZED` - ユーザーは提供されたアカウントにアクセスできません。 -* `SINCE_NOT_SUPPORTED` - SINCE 句はサポートされていません。 -* `TIMESERIES_NOT_SUPPORTED` - TIMESERIES 句はサポートされていません。 -* `TOO_MANY_FACET_VALUES` - クエリが異常検出ファセットの制限を超えました。 -* `UNTIL_NOT_SUPPORTED` - UNTIL 句はサポートされていません。 - -## 異常検知のしきい値 - -閾値とは、信号が異常であると判断される上限& または下限を示す設定のグループです。異常検出器の設定を作成すると、ほとんどの検出器に適したデフォルトの設定が使用されます。 - -#### しきい値の照会 [#query-thresholds] - -デフォルト値には、単一グローバルしきい値と信号しきい値の 2 種類があります。異常検出器に関連付けられたしきい値をクエリする場合、 `WorkloadAnomalyDetector`または`EntityTypeAnomalyDetector`内の null 値は、シグナルのデフォルト値が使用されていることを示します。 - -NrqlAnomalyDetector内のNULL値は、グローバルなデフォルト値が使用されていることを示します。これらのデフォルト値は時間の経過とともに変更される可能性があります。最新のデフォルト値を取得するには、 [thresholds query](#query-thresholds) を使用してください。 - -#### しきい値の更新 [#update-thresholds] - -閾値の変更は、任意の構成編集変異で行うことができる。ワークロードおよびエンティティタイプの設定には、エンティティタイプごとにゴールデンシグナルごとに1つの閾値のリストがあります（ワークロードには複数のエンティティタイプを含めることができます）。 - -NRQL 構成には、カスタム シグナルごとに 1 つのしきい値があります。以下は、[更新ミュー](#update-configuration)テーションでしきい値を更新するために使用される THRESHOLD オブジェクトの例です。 - -``` -{ - signalName: "SIGNAL_NAME", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - deviationSensitivity: DEVIATION_SENSITIVITY, - significantDeviationDirection: SIGNIFICANT_DEVIATION_DIRECTION, - upperLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - upperRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - }, - lowerLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - lowerRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - } -} -``` - -このタイプの詳細をご紹介します。 - -* `signalName`: 信号名。_nrql 構成の場合、この名前は`nrqlSignal.name`と一致する必要があります_。 -* `domainType`: カスタム NRQL シグナルの場合は null になります。 -* `domain`: エンティティ ドメインを表す文字列。 -* `type`: エンティティ タイプを表す文字列。 -* `deviationSensitivity`: オプション。どのデータが異常であるかを判断するための機密レベル。値のオプションは次のとおりです。 - - -* `NONE` - 異常なし。 -* `LOW` - 異常が少ない。たとえば、ホストの CPU 使用率があまりにも多くの異常を生成しているため、それを減らしたいと判断する場合があります。 -* `MEDIUM` - いくつかの異常。 -* `HIGH` - より多くの異常。たとえば、サービスのエラー率が生成する異常が少なすぎて、もっと多くしたいと判断する場合があります。 - - -* `significantDeviationDirection`: オプション。信号に関連する変化の方向を決定するための重要な方向。値のオプションは次のとおりです。 - - -* `HIGHER` - 相対変化が大きい場合は異常です。たとえば、サービスのエラー率は、上昇した場合にのみ異常であると判断する場合があります。 -* `HIGHER_LOWER` - 相対変化が高いか低い場合は異常です。 -* `LOWER` - 相対変化が低い場合は異常です。たとえば、サービスのスループットが異常なのは、サービスがダウンしたときだけだと判断する場合があります。 - - -* `upperLimit`: オプション。静的上限。有意偏差の方向が`HIGHER`または`HIGHER_LOWER`の場合、この制限値を超える値はすべて異常と見なされます。 -* `value`: オプション。数値。 -* `active`: オプション。正しいか間違っているか。 -* `upperRelativePercent`: オプション。有意な偏差の方向が`HIGHER`または`HIGHER_LOWER`の場合、このパーセント値より高い相対変化率は異常と見なされます。 -* `value`: オプション。数値。 -* `active`: オプション。正しいか間違っているか。 -* `lowerLimit`: オプション。静的下限。有意偏差の方向が`LOWER`または`HIGHER_LOWER`の場合、この制限値を下回る値はすべて異常と見なされます。 -* `value`: オプション。数値。 -* `active`: オプション。正しいか間違っているか。 -* `lowerRelativePercent`: オプション。有意偏差の方向が`LOWER`または`HIGHER_LOWER`の場合、このパーセント値より低い相対変化率は異常と見なされます。 -* `value`: オプション。数値。 -* `active`: オプション。正しいか間違っているか。 \ No newline at end of file diff --git a/src/i18n/content/kr/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx b/src/i18n/content/kr/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx deleted file mode 100644 index 01ea4eab425..00000000000 --- a/src/i18n/content/kr/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx +++ /dev/null @@ -1,519 +0,0 @@ ---- -title: 'NerdGraph 튜토리얼: 이상 감지 구성' -tags: - - APIs - - NerdGraph -metaDescription: How to use New Relic NerdGraph API to query and update anomaly detector configurations. -freshnessValidatedDate: never -translationType: machine ---- - -New Relic의 자동 이상 감지는 이상 감지기에서 시작됩니다. 특정 데이터 세트에서 이상을 체계적으로 관찰하고 기록하는 방법입니다. 데이터 세트의 이름을 지정하고 구성하려면 관찰하려는 신호와 비정상적인 데이터를 저장할 위치를 알려주는 필드 세트인 이상 감지기 구성을 생성해야 합니다. - - - 이 기능은 아직 미리 보기 단계이지만 사용해 보시기 바랍니다! - - -감시할 데이터 세트를 만드는 다양한 방법에 해당하는 세 가지 유형의 구성이 있습니다. 워크로드 구성은 [워크로드](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) 에 포함된 모든 엔터티를 데이터세트로 사용하여 감지기를 생성합니다. 엔터티 유형 구성은 하나 이상의 계정에 있는 단일 [엔터티 유형](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) (예: 모바일 앱)의 모든 엔터티를 데이터 세트로 사용합니다. NRQL 구성은 하나 이상의 [NRQL 쿼리](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) 결과를 데이터세트로 사용합니다. - -api.newrelic.com/graphiql에서 [GraphiQL](https://api.newrelic.com/graphiql) 인터페이스 사용을 포함하는 [NerdGraph API](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph) 로 이상 감지기 구성을 관리할 수 있습니다. - -다음은 시작하는 데 도움이 되는 몇 가지 예입니다. - -* [구성 만들기](#create-configuration) -* [구성 업데이트](#update-configuration) -* [구성 삭제](#delete-configuration) -* [구성 쿼리](#query-configurations) -* [쿼리 기본 임계값](#query-thresholds) - -## 구성 만들기 [#create-configuration] - -다음은 기존 [워크로드](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) 를 사용하여 구성을 생성하는 NerdGraph [변형](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph#terminology) 의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorCreate( - workloadGuid: "WORKLOAD_GUID", - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...] - } - ) - { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `workloadGuid`: 데이터세트를 정의하는 데 사용되는 [워크로드 가이드](/docs/new-relic-one/use-new-relic-one/core-concepts/new-relic-one-workloads-isolate-resolve-incidents-faster#workload-account) 입니다. 이 워크로드 내에서 모든 항목( `excludedEntityGuids` 에 지정되지 않은 경우)의 골든 신호를 기반으로 이상 항목이 감지됩니다. 비정상적인 데이터는 이 워크로드와 연결된 계정에 저장됩니다. 워크로드는 나중에 편집할 수 없습니다. -* `anomalyDetector.name`: 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.excludedEntityGuids`: 선택 사항입니다. 이 필드를 사용하면 워크로드에서 제거하지 않고 데이터 세트에서 일부 엔터티를 제외할 수 있습니다. 이는 이상 감지에 사용하려는 기존 워크로드가 있는 경우에 유용합니다. - -다음은 [엔티티 유형](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) 을 사용하여 구성을 생성하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `accountId`: 비정상적인 데이터를 저장하고 데이터 세트의 엔터티를 결정하는 데 사용되는 accountId입니다. 이 계정은 나중에 수정할 수 없습니다. -* `anomalyDetector.name`: 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.domainType`: -* `domain`: 엔터티 도메인을 나타내는 문자열입니다. -* `type`: 엔터티 유형을 나타내는 문자열입니다. -* `anomalyDetector.includedEntityGuids`: 선택 사항입니다. 이 필드를 사용하면 계정에서 모든 항목을 추가하지 않고도 데이터세트에 일부 항목을 포함할 수 있습니다. 이는 이상 감지에 사용하려는 동일한 유형의 엔터티가 몇 개뿐이거나 정적 데이터 세트를 원하는 경우에 유용합니다. 기본값은 엔터티 유형 내의 모든 엔터티를 사용하는 것이며 시간이 지남에 따라 변경될 수 있습니다. -* `anomalyDetector.additionalSourceAccountIds`: 선택 사항입니다. 이 필드를 사용하면 데이터세트에 둘 이상의 계정에서 엔터티를 포함할 수 있습니다. 이 계정은 나중에 편집할 수 있습니다. - -다음은 [NRQL 쿼리](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) 결과를 사용하여 구성을 생성하는 변형의 예입니다. - - - 모든 NRQL 기능이 이상 감지에서 지원되는 것은 아닙니다. 잘못된 nrql 오류를 방지하려면 먼저 [유효성 검사 변형](#validate-nrql) 을 통해 신호의 NRQL을 실행하십시오. - - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - nrqlSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ] - } - ) - { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `accountId`: 비정상적인 데이터를 저장하는 데 사용되는 accountId입니다. 이 계정은 나중에 수정할 수 있습니다. -* `anomalyDetector.name`: 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.nrqlSignals`: 사용자 정의 NRQL 쿼리에 의해 정의된 신호 목록입니다. -* `accountId`: accountId가 쿼리되고 있습니다. -* `name`: 신호를 설명하기 위해 사용자에게 친숙한 이름을 가진 문자열입니다. 예: "처리량", "ErrorRate" 등 -* `nrql`: [NRQL 쿼리](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) . 이상 감지는 현재 모든 NRQL 기능을 지원하지 않습니다. 구성을 생성하기 전에 [검증 변형](#validate-nrql) 을 사용하여 NRQL 쿼리가 완전히 지원되는지 확인할 수 있습니다. -* `mutedFacetValues`: 선택 사항입니다. 이 필드를 사용하면 결과 데이터 세트에서 일부 패싯 값을 제외할 수 있습니다. - -## 구성 업데이트 [#update-configuration] - -다음은 [워크로드](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) 구성을 업데이트하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `anomalyDetectorId`: 감지기의 고유 식별자입니다. -* `anomalyDetector.name`: 선택 사항입니다. 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.status`: 선택 사항입니다. 상태 기본값은 `ACTIVE` 입니다. 감지기가 이상을 생성하지 않도록 하려면 이 필드를 `INACTIVE` 로 설정할 수 있습니다. -* `anomalyDetector.deviationSensitivity`: 선택 사항입니다. 어떤 데이터가 비정상인지 판단하기 위한 민감도 수준입니다. 이 필드의 기본값은 `LOW` 이며 가장 중요한 이상만 기록합니다. 감도를 높이려면 이 필드를 `MEDIUM` 또는 `HIGH` 로 설정할 수 있습니다. -* `anomalyDetector.excludedEntityGuids`: 선택 사항입니다. 이 필드를 사용하면 워크로드에서 제거하지 않고 데이터 세트에서 일부 엔터티를 제외할 수 있습니다. 이는 이상 감지에 사용하려는 기존 워크로드가 있는 경우에 유용합니다. 기존의 excludeEntityGuids를 지우려면 빈 배열 `[]` 을 전달하십시오. -* `anomalyDetector.thresholds`: 선택 사항입니다. 자세한 내용은 [임계값](#update-thresholds) 섹션을 참조하세요. - -다음은 [항목 유형](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) 구성을 업데이트하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `anomalyDetectorId`: 감지기의 고유 식별자입니다. -* `anomalyDetector.name`: 선택 사항입니다. 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.status`: 선택 사항입니다. 상태 기본값은 `ACTIVE` 입니다. 감지기가 이상을 생성하지 않도록 하려면 이 필드를 `INACTIVE` 로 설정할 수 있습니다. -* `anomalyDetector.deviationSensitivity`: 선택 사항입니다. 어떤 데이터가 비정상인지 판단하기 위한 민감도 수준입니다. 이 필드의 기본값은 `LOW` 이며 가장 중요한 이상만 기록합니다. 감도를 높이려면 이 필드를 `MEDIUM` 또는 `HIGH` 로 설정할 수 있습니다. -* `anomalyDetector.includedEntityGuids`: 선택 사항입니다. 이 필드를 사용하면 계정에서 모든 항목을 추가하는 대신 항목 유형의 일부 항목을 포함할 수 있습니다. 이는 이상 탐지에 사용하려는 동일한 유형의 엔터티가 몇 개 없는 경우에 유용합니다. 유형 내의 모든 항목을 사용하려면 빈 배열 `[]` 을 전달합니다. -* `anomalyDetector.additionalSourceAccountIds`: 선택 사항입니다. 이 필드를 사용하면 데이터세트에 둘 이상의 계정에서 엔터티를 포함할 수 있습니다. -* `anomalyDetector.thresholds`: 선택 사항입니다. 자세한 내용은 [임계값](#update-thresholds) 섹션을 참조하세요. - -다음은 [NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) 구성을 업데이트하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "UPDATED_CONFIGURATION_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - newSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ], - updatedSignals: [ - { - queryId: QUERY_ID, - name: "UPDATED_NAME_OF_NRQL_SIGNAL", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...], - threshold: THRESHOLD - } - ], - deletedQueries: [QUERY_ID_1, QUERY_ID_2] - } - ) - { - anomalyDetectorId - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `anomalyDetectorId`: 감지기의 고유 식별자입니다. -* `accountId`: 선택 사항입니다. 비정상적인 데이터를 저장하는 데 사용되는 accountId입니다. -* `anomalyDetector.name`: 선택 사항입니다. 구성을 설명하는 사용자에게 친숙한 이름의 문자열입니다. -* `anomalyDetector.status`: 선택 사항입니다. 상태 기본값은 `ACTIVE` 입니다. 감지기가 이상을 생성하지 않도록 하려면 이 필드를 `INACTIVE` 로 설정할 수 있습니다. -* `anomalyDetector.deviationSensitivity`: 선택 사항입니다. 어떤 데이터가 비정상인지 판단하기 위한 민감도 수준입니다. 이 필드의 기본값은 `LOW` 이며 가장 중요한 이상만 기록합니다. 감도를 높이려면 이 필드를 `MEDIUM` 또는 `HIGH` 로 설정할 수 있습니다. -* `anomalyDetector.newSignals`: 선택 사항입니다. 감지기에 추가할 신호 목록입니다. -* `accountId`: accountId가 쿼리되고 있습니다. -* `name`: 신호를 설명하기 위해 사용자에게 친숙한 이름을 가진 문자열입니다. 예: "처리량", "ErrorRate" 등 -* `nrql`: [NRQL 쿼리](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) . 이상 감지는 현재 모든 NRQL 기능을 지원하지 않습니다. 구성을 생성하기 전에 [검증 변형](#validate-nrql) 을 사용하여 NRQL 쿼리가 완전히 지원되는지 확인할 수 있습니다. -* `mutedFacetValues`: 선택 사항입니다. 이 필드를 사용하면 결과 데이터 세트에서 일부 패싯 값을 제외할 수 있습니다. -* `anomalyDetector.updatedSignals`: 선택 사항입니다. 변경 사항이 있는 신호 목록입니다. -* `queryId`: 고유한 신호 쿼리 식별자입니다. -* `name`: 선택 사항입니다. 신호를 설명하는 사용자에게 친숙한 이름의 문자열입니다. 예: "처리량", "ErrorRate" 등 -* `mutedFacetValues`: 선택 사항입니다. 이 필드를 사용하면 결과 데이터 세트에서 일부 패싯 값을 제외할 수 있습니다. -* `threshold`: 선택 사항입니다. 자세한 내용은 [임계값](#update-thresholds) 섹션을 참조하세요. -* `anomalyDetector.deletedQueries`: 선택 사항입니다. 감지기에서 제거할 고유한 신호 쿼리 식별자 목록입니다. - -## 구성 삭제 [#delete-configuration] - -다음은 모든 종류의 구성을 삭제하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsAnomalyDetectorDelete( - anomalyDetectorId: DETECTOR_ID - ) - { - success - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `anomalyDetectorId`: 감지기의 고유 식별자입니다. - -## 이상 감지기 구성 쿼리 [#query-configurations] - -다음은 액세스 권한이 있는 모든 구성을 반환하는 변형의 예입니다. - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - ... on AnomalyDetectorConfigurationsWorkloadAnomalyDetector { - workloadGuid { - guid - } - } - ... on AnomalyDetectorConfigurationsEntityTypeAnomalyDetector { - domainType { - domain - type - } - } - ... on AnomalyDetectorConfigurationsNrqlAnomalyDetector { - nrqlSignals { - name - } - } - } - } - } -} -``` - -모든 유형의 구성에서 액세스할 수 있는 필드에 관심이 있는 경우 단순화된 쿼리를 사용할 수 있습니다. - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - } - } - } -} -``` - -하나 이상의 특정 구성을 검색하려면 다음과 같이 고유 식별자가 포함된 필터를 이전 쿼리에 전달합니다. - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors(filters: {anomalyDetectorIds: [ANOMALY_DETECTOR_ID_1, ANOMALY_DETECTOR_ID_2, ...]}) { - id - name - } - } - } -} - -``` - -이 쿼리의 일부에 대한 세부정보: - -* `filters`: 선택 사항입니다. -* `filters.anomalyDetectorIds`: 선택 사항입니다. 고유한 이상 감지기 식별자 목록입니다. - -쿼리 가능한 필드를 더 보려면 [QraphiQL 탐색기](https://api.newrelic.com/graphiql) 를 방문하십시오. - -## 쿼리 기본 임계값 [#query-thresholds] - -다음은 현재 기본 [임계값](#query-thresholds) 을 반환하는 쿼리의 예입니다. - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds { - signalName - domainType { - domain - type - } - deviationSensitivity - upperLimit { - active - value - } - upperRelativePercent { - active - value - } - significantDeviationDirection - lowerRelativePercent { - value - active - } - lowerLimit { - active - value - } - } - } - } -} -``` - -이 쿼리에 대한 몇 가지 세부정보: - -* **signalName** : **globalDefault** 라는 전역 임계값 또는 신호 임계값(예: "throughput", "errorRate" 등)을 나타내는 문자열 -* **domainType** : 전역 임계값에 도메인 유형이 없습니다. - -임계값을 하나 이상의 domainTypes로 필터링하려면 다음과 같이 이전 쿼리에 필터를 전달합니다. - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds(filters: { - domainTypes: [ - { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - } - ] - } - ) - { - signalName - } - } - } -} -``` - -이 쿼리의 일부에 대한 세부정보: - -* `domainType.domain`: 엔터티 도메인을 나타내는 문자열입니다. -* `domainType.type`: 엔터티 유형을 나타내는 문자열입니다. - -## 사용자 지정 NRQL 신호 검증 [#validate-nrql] - -이것은 NRQL 기반의 이상 탐지기를 생성할 때만 유용합니다. 이상 탐지는 모든 NRQL 기능을 지원하지 않습니다. 생성 시 오류를 방지하려면 먼저 사용하려는 NRQL 쿼리의 유효성을 검사할 수 있습니다. 귀하의 쿼리가 유효하지 않은 경우 이유 목록을 제공합니다. 빈 목록은 쿼리가 유효함을 나타냅니다. - -다음은 NRQL 쿼리가 이상 감지에서 완전히 지원되는지 확인하는 변형의 예입니다. - -``` -mutation { - anomalyDetectorConfigurationsValidateNrqlSignal( - accountId: ACCOUNT_ID, - nrql: "NRQL" - ) { - invalidNrqlReasons - } -} -``` - -이 돌연변이에 대한 몇 가지 세부사항: - -* `accountId`: accountId가 쿼리되고 있습니다. -* `nrql`: [NRQL 쿼리](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) . - -쿼리가 유효하지 않을 수 있는 이유: - -* `CASES_NOT_SUPPORTED` - 케이스는 지원하지 않습니다. -* `COMPARE_WITH_NOT_SUPPORTED` - COMPARE WITH 절은 지원하지 않습니다. -* `COULDNT_COMPLETE_QUERY` - 쿼리가 지원하는 이상 탐지에 대해 너무 많은 데이터를 반환했습니다. -* `DAQS_NOT_ALLOWED` - DAQS는 쿼리를 지원하지 않습니다. -* `INVALID_NRQL` - 쿼리가 잘못되었습니다. -* `LIMIT_NOT_SUPPORTED` - LIMIT 절은 지원하지 않습니다. -* `MISSING_FACET` - 쿼리에 패싯 값이 누락되었습니다. -* `MULTIPLE_FACET_NOT_SUPPORTED` - 쿼리당 여러 패싯 속성이 지원되지 않습니다. -* `MULTISELECT_NOT_SUPPORTED` - 다중 SELECT 절은 지원하지 않습니다. -* `NON_NUMERIC_AGGREGATE_NOT_SUPPORTED` - 숫자가 아닌 값을 반환하는 쿼리는 지원되지 않습니다. -* `NOT_AUTHORIZED` - 사용자는 제공된 계정에 액세스할 수 없습니다. -* `SINCE_NOT_SUPPORTED` - SINCE 절은 지원하지 않습니다. -* `TIMESERIES_NOT_SUPPORTED` - TIMESERIES 절은 지원하지 않습니다. -* `TOO_MANY_FACET_VALUES` - 쿼리가 이상 탐지 패싯 한도를 초과했습니다. -* `UNTIL_NOT_SUPPORTED` - UNTIL 절은 지원하지 않습니다. - -## 이상 감지기 임계값 - -임계값은 신호가 비정상적인 것으로 간주될 때를 나타내는 상한 및/또는 하한을 나타내는 설정 그룹입니다. 이상 감지기 구성이 생성되면 대부분의 감지기에 적합한 기본 설정을 사용하기 시작합니다. - -#### 임계값 쿼리 [#query-thresholds] - -기본값에는 단일 전역 임계값과 신호 임계값의 두 가지 유형이 있습니다. 이상 감지기와 연결된 임계값을 쿼리할 때 `WorkloadAnomalyDetector` 또는 `EntityTypeAnomalyDetector` 내의 null 값은 신호 기본값이 사용 중임을 나타냅니다. - -NrqlAnomalyDetector 내의 null 값은 전역 기본값이 사용 중임을 나타냅니다. 이러한 기본값은 시간이 지남에 따라 변경될 수 있습니다. [임계값 쿼리](#query-thresholds) 를 사용하여 가장 최근의 기본값을 가져옵니다. - -#### 임계값 업데이트 [#update-thresholds] - -구성 편집 변형에서 임계값을 변경할 수 있습니다. 워크로드 및 엔터티 유형 구성에는 엔터티 유형당 골든 신호당 하나씩 임계값 목록이 있습니다(워크로드에는 여러 엔터티 유형이 포함될 수 있음). - -NRQL 구성에는 사용자 지정 신호당 단일 임계값이 있습니다. 다음은 [업데이트 변형](#update-configuration) 에서 임계값을 업데이트하는 데 사용되는 THRESHOLD 개체의 예입니다. - -``` -{ - signalName: "SIGNAL_NAME", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - deviationSensitivity: DEVIATION_SENSITIVITY, - significantDeviationDirection: SIGNIFICANT_DEVIATION_DIRECTION, - upperLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - upperRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - }, - lowerLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - lowerRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - } -} -``` - -이 유형에 대한 몇 가지 세부정보: - -* `signalName`: 신호 이름. _nrql 구성의 경우 이 이름은 `nrqlSignal.name` 과 일치해야 합니다_ . -* `domainType`: 사용자 지정 NRQL 신호의 경우 null이 됩니다. -* `domain`: 엔터티 도메인을 나타내는 문자열입니다. -* `type`: 엔터티 유형을 나타내는 문자열입니다. -* `deviationSensitivity`: 선택 사항입니다. 어떤 데이터가 비정상인지 판단하기 위한 민감도 수준입니다. 값 옵션은 다음과 같습니다. - - -* `NONE` - 이상 없음. -* `LOW` - 더 적은 변칙. 예를 들어, 호스트의 CPU 사용량이 너무 많은 변칙을 생성하고 더 적게 원할 수 있다고 결정할 수 있습니다. -* `MEDIUM` - 일부 변칙. -* `HIGH` - 더 많은 변칙. 예를 들어, 서비스의 오류율이 너무 적은 변칙을 생성하고 더 많은 것을 원한다고 결정할 수 있습니다. - - -* `significantDeviationDirection`: 선택 사항입니다. 신호와 관련된 변경 방향을 결정하기 위한 중요한 방향입니다. 값 옵션은 다음과 같습니다. - - -* `HIGHER` - 상대적 변화가 높을 때 변칙적이다. 예를 들어 서비스의 오류율이 증가할 때만 비정상적이라고 결정할 수 있습니다. -* `HIGHER_LOWER` - 상대적 변화가 높거나 낮을 때 비정상적입니다. -* `LOWER` - 상대적 변화가 낮을 때 비정상적이다. 예를 들어 서비스 처리량이 중단될 때만 비정상적이라고 결정할 수 있습니다. - - -* `upperLimit`: 선택 사항입니다. 정적 상한입니다. 이 한계값을 초과하는 값은 상당한 편차 방향이 `HIGHER` 또는 `HIGHER_LOWER` 때 비정상적인 것으로 간주됩니다. -* `value`: 선택 사항입니다. 숫자 값입니다. -* `active`: 선택 사항입니다. 참 또는 거짓. -* `upperRelativePercent`: 선택 사항입니다. 이 백분율 값보다 높은 상대 백분율 변경은 상당한 편차 방향이 `HIGHER` 또는 `HIGHER_LOWER` 때 비정상적인 것으로 간주됩니다. -* `value`: 선택 사항입니다. 숫자 값입니다. -* `active`: 선택 사항입니다. 참 또는 거짓. -* `lowerLimit`: 선택 사항입니다. 정적 하한. 이 한계값 미만의 값은 상당한 편차 방향이 `LOWER` 또는 `HIGHER_LOWER` 때 비정상적인 것으로 간주됩니다. -* `value`: 선택 사항입니다. 숫자 값입니다. -* `active`: 선택 사항입니다. 참 또는 거짓. -* `lowerRelativePercent`: 선택 사항입니다. 이 백분율 값보다 낮은 상대 백분율 변경은 상당한 편차 방향이 `LOWER` 또는 `HIGHER_LOWER` 때 비정상적인 것으로 간주됩니다. -* `value`: 선택 사항입니다. 숫자 값입니다. -* `active`: 선택 사항입니다. 참 또는 거짓. \ No newline at end of file diff --git a/src/i18n/content/pt/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx b/src/i18n/content/pt/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx deleted file mode 100644 index bdcefec1157..00000000000 --- a/src/i18n/content/pt/docs/nerdgraph-anomaly-detector-configurations-api-tutorial.mdx +++ /dev/null @@ -1,528 +0,0 @@ ---- -title: 'Tutorial NerdGraph: Configurar detecção de anomalia' -tags: - - APIs - - NerdGraph -metaDescription: How to use New Relic NerdGraph API to query and update anomaly detector configurations. -freshnessValidatedDate: never -translationType: machine ---- - -A detecção automatizada de anomalias na New Relic começa com um detector de anomalias: uma maneira de observar e registrar sistematicamente anomalias em um conjunto de dados específico. Para nomear e configurar o conjunto de dados, você precisará criar uma configuração do detector de anomalias, que é um conjunto de campos que nos informa os sinais que você está interessado em observar e onde armazenar os dados anômalos. - - - Este recurso ainda está em versão prévia, mas encorajamos você a experimentá-lo! - - -Existem três tipos diferentes de configuração que correspondem a diferentes formas de criar um conjunto de dados para monitorar. Uma configuração de workload cria um detector usando toda a entidade contida na [workload](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) como conjunto de dados. Uma configuração de tipo de entidade usa todas as entidades de um único [tipo de entidade](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) (por exemplo, aplicativos móveis) em uma ou mais contas como conjunto de dados. Uma configuração NRQL usa os resultados de uma ou mais [consultasNRQL ](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/)como conjunto de dados. - -Você pode gerenciar a configuração do seu detector de anomalias com nossa [API NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph), que inclui o uso de nossa interface GraphiQL em [api.newrelic.com/graphiql](https://api.newrelic.com/graphiql). - -Aqui estão alguns exemplos para você começar: - -* [Crie uma configuração](#create-configuration) -* [Atualizar uma configuração](#update-configuration) -* [Excluir uma configuração](#delete-configuration) -* [consulte sua configuração](#query-configurations) -* [consultar limite padrão](#query-thresholds) - -## Crie uma configuração [#create-configuration] - -A seguir está um exemplo de [mutação](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph#terminology) do NerdGraph que cria uma configuração usando uma [workload](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) existente: - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorCreate( - workloadGuid: "WORKLOAD_GUID", - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...] - } - ) - { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `workloadGuid`: o [guia de carga de trabalho](/docs/new-relic-one/use-new-relic-one/core-concepts/new-relic-one-workloads-isolate-resolve-incidents-faster#workload-account) usado para definir o conjunto de dados. A anomalia será detectada com base em sinais clássicos de todas as entidades (a menos que especificado em `excludedEntityGuids`) nesta workload. Os dados anômalos serão armazenados na conta associada a esta workload. A workload não pode ser editada posteriormente. -* `anomalyDetector.name`: Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.excludedEntityGuids`: Opcional. Este campo permite excluir algumas entidades do conjunto de dados sem removê-las da workload. Isto é útil se você tiver uma workload existente que deseja usar para detecção de anomalias. - -A seguir está um exemplo de mutação que cria uma configuração usando um [tipo de entidade](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic): - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `accountId`: O accountId usado para armazenar dados anômalos e determinar a entidade do conjunto de dados. Esta conta não pode ser editada posteriormente. -* `anomalyDetector.name`: Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.domainType`: -* `domain`: Uma string que representa um domínio de entidade. -* `type`: Uma string que representa um tipo de entidade. -* `anomalyDetector.includedEntityGuids`: Opcional. Este campo permite incluir alguma entidade no conjunto de dados sem adicionar todas elas da(s) conta(s). Isto é útil se você tiver apenas algumas entidades do mesmo tipo que deseja usar para detecção de anomalias ou se desejar um conjunto de dados estático. O padrão é usar toda entidade dentro do tipo entidade, que pode mudar com o tempo. -* `anomalyDetector.additionalSourceAccountIds`: Opcional. Este campo permite incluir entidades de mais de uma conta no conjunto de dados. Essas contas podem ser editadas posteriormente. - -A seguir está um exemplo de mutação que cria uma configuração usando os resultados de uma [consulta NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/): - - - Nem todos os recursos NRQL são suportados pela detecção de anomalias. Para evitar erros NRQL inválidos, execute primeiro NRQL do seu sinal através da [mutação de validação](#validate-nrql) . - - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorCreate( - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "NAME_OF_CONFIGURATION", - nrqlSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ] - } - ) - { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `accountId`: O accountId usado para armazenar dados anômalos. Esta conta pode ser editada posteriormente. -* `anomalyDetector.name`: Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.nrqlSignals`: Uma lista de sinais definidos pela consulta NRQL personalizada. -* `accountId`: O accountId sendo consultado. -* `name`: Uma string com um nome amigável ao usuário para descrever o sinal. Por exemplo: "Throughput", "ErrorRate", etc. -* `nrql`: Uma [consulta NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/). a detecção de anomalias não suporta atualmente todos os recursos NRQL . Você pode usar nossa [mutação de validação](#validate-nrql) para verificar se sua consulta NRQL é totalmente suportada antes de criar uma configuração. -* `mutedFacetValues`: Opcional. Este campo permite excluir alguns valores de faceta do conjunto de dados resultante. - -## Atualizar uma configuração [#update-configuration] - -Veja a seguir um exemplo de mutação que atualiza uma configuração [workload](/docs/new-relic-one/use-new-relic-one/workloads/workloads-isolate-resolve-incidents-faster) : - -``` -mutation { - anomalyDetectorConfigurationsWorkloadAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - excludedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `anomalyDetectorId`: O identificador exclusivo do detector. -* `anomalyDetector.name`: Opcional. Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.status`: Opcional. O status padrão é `ACTIVE`. Se não quiser que o detector produza anomalia, você pode definir este campo como `INACTIVE`. -* `anomalyDetector.deviationSensitivity`: Opcional. O nível de sensibilidade para determinar quais dados são anômalos. Este campo tem como padrão `LOW`, registrando apenas a anomalia mais significativa. Se desejar mais sensibilidade, você pode definir este campo como `MEDIUM` ou `HIGH`. -* `anomalyDetector.excludedEntityGuids`: Opcional. Este campo permite excluir algumas entidades do conjunto de dados sem removê-las da workload. Isto é útil se você tiver uma workload existente que deseja usar para detecção de anomalias. Se você quiser limpar qualquer excludeEntityGuids existente, passe uma matriz vazia `[]`. -* `anomalyDetector.thresholds`: Opcional. Consulte a seção sobre [limite](#update-thresholds) para obter mais informações. - -A seguir está um exemplo de mutação que atualiza uma configuração [de tipo de entidade](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic) : - -``` -mutation { - anomalyDetectorConfigurationsEntityTypeAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - anomalyDetector: { - name: "UPDATED_DETECTOR_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - includedEntityGuids: ["ENTITY_GUID_1", "ENTITY_GUID_2", ...], - additionalSourceAccountIds: [ADDITIONAL_SOURCE_ACCOUNT_ID_1, ADDITIONAL_SOURCE_ACCOUNT_ID_2, ...], - thresholds: [THRESHOLD_SIGNAL_1, THRESHOLD_SIGNAL_2, ...] - } - ) - { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `anomalyDetectorId`: O identificador exclusivo do detector. -* `anomalyDetector.name`: Opcional. Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.status`: Opcional. O status padrão é `ACTIVE`. Se não quiser que o detector produza anomalia, você pode definir este campo como `INACTIVE`. -* `anomalyDetector.deviationSensitivity`: Opcional. O nível de sensibilidade para determinar quais dados são anômalos. Este campo tem como padrão `LOW`, registrando apenas a anomalia mais significativa. Se desejar mais sensibilidade, você pode definir este campo como `MEDIUM` ou `HIGH`. -* `anomalyDetector.includedEntityGuids`: Opcional. Este campo permite incluir alguma entidade do tipo entidade em vez de adicionar todas da(s) conta(s). Isto é útil se você tiver apenas algumas entidades do mesmo tipo que deseja utilizar para detecção de anomalias. Caso queira utilizar toda entidade dentro do tipo, passe uma matriz vazia `[]`. -* `anomalyDetector.additionalSourceAccountIds`: Opcional. Este campo permite incluir entidades de mais de uma conta no conjunto de dados. -* `anomalyDetector.thresholds`: Opcional. Consulte a seção sobre [limite](#update-thresholds) para obter mais informações. - -A seguir está um exemplo de mutação que atualiza uma configuração [NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/) : - -``` -mutation { - anomalyDetectorConfigurationsNrqlAnomalyDetectorUpdate( - anomalyDetectorId: DETECTOR_ID, - accountId: ACCOUNT_ID, - anomalyDetector: { - name: "UPDATED_CONFIGURATION_NAME", - status: DETECTOR_STATUS, - deviationSensitivity: DEVIATION_SENSITIVITY, - newSignals: [ - { - accountId: NRQL_QUERY_ACCOUNT_ID, - name: "NAME_OF_NRQL_SIGNAL", - nrql: "NRQL_QUERY", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...] - } - ], - updatedSignals: [ - { - queryId: QUERY_ID, - name: "UPDATED_NAME_OF_NRQL_SIGNAL", - mutedFacetValues: ["FACET_VALUE_1", "FACET_VALUE_2", ...], - threshold: THRESHOLD - } - ], - deletedQueries: [QUERY_ID_1, QUERY_ID_2] - } - ) - { - anomalyDetectorId - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `anomalyDetectorId`: O identificador exclusivo do detector. -* `accountId`: Opcional. O accountId usado para armazenar dados anômalos. -* `anomalyDetector.name`: Opcional. Uma string com um nome amigável ao usuário para descrever a configuração. -* `anomalyDetector.status`: Opcional. O status padrão é `ACTIVE`. Se não quiser que o detector produza anomalia, você pode definir este campo como `INACTIVE`. -* `anomalyDetector.deviationSensitivity`: Opcional. O nível de sensibilidade para determinar quais dados são anômalos. Este campo tem como padrão `LOW`, registrando apenas a anomalia mais significativa. Se desejar mais sensibilidade, você pode definir este campo como `MEDIUM` ou `HIGH`. -* `anomalyDetector.newSignals`: Opcional. Uma lista de sinais a serem adicionados ao detector. -* `accountId`: O accountId sendo consultado. -* `name`: Uma string com um nome amigável ao usuário para descrever o sinal. Por exemplo: "Throughput", "ErrorRate", etc. -* `nrql`: Uma [consulta NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/). a detecção de anomalias não suporta atualmente todos os recursos NRQL . Você pode usar nossa [mutação de validação](#validate-nrql) para verificar se sua consulta NRQL é totalmente suportada antes de criar uma configuração. -* `mutedFacetValues`: Opcional. Este campo permite excluir alguns valores de faceta do conjunto de dados resultante. -* `anomalyDetector.updatedSignals`: Opcional. Uma lista de sinais com alterações. -* `queryId`: Um identificador de consulta de sinal exclusivo. -* `name`: Opcional. Uma string com um nome amigável ao usuário para descrever o sinal. Por exemplo: "taxas de transferência", "ErrorRate", etc. -* `mutedFacetValues`: Opcional. Este campo permite excluir alguns valores de faceta do conjunto de dados resultante. -* `threshold`: Opcional. Consulte a seção sobre [limite](#update-thresholds) para obter mais informações. -* `anomalyDetector.deletedQueries`: Opcional. Uma lista de identificadores de consulta de sinal exclusivos para remover do detector. - -## Excluir uma configuração [#delete-configuration] - -A seguir está um exemplo de mutação que exclui qualquer tipo de configuração: - -``` -mutation { - anomalyDetectorConfigurationsAnomalyDetectorDelete( - anomalyDetectorId: DETECTOR_ID - ) - { - success - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `anomalyDetectorId`: O identificador exclusivo do detector. - -## Consulte seu detector de configuração de anomalia [#query-configurations] - -A seguir está um exemplo de mutação que retorna todas as configurações às quais você tem acesso: - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - ... on AnomalyDetectorConfigurationsWorkloadAnomalyDetector { - workloadGuid { - guid - } - } - ... on AnomalyDetectorConfigurationsEntityTypeAnomalyDetector { - domainType { - domain - type - } - } - ... on AnomalyDetectorConfigurationsNrqlAnomalyDetector { - nrqlSignals { - name - } - } - } - } - } -} -``` - -Uma consulta simplificada pode ser utilizada quando você estiver interessado em campos acessíveis em todos os tipos de configuração: - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors { - id - name - } - } - } -} -``` - -Caso queira recuperar uma ou mais configurações específicas, passe um filtro contendo identificador único para a consulta anterior assim: - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectors(filters: {anomalyDetectorIds: [ANOMALY_DETECTOR_ID_1, ANOMALY_DETECTOR_ID_2, ...]}) { - id - name - } - } - } -} - -``` - -Alguns detalhes sobre partes desta consulta: - -* `filters`: Opcional. -* `filters.anomalyDetectorIds`: Opcional. Uma lista de identificadores exclusivos de detectores de anomalias. - -Visite o [explorador QraphiQL](https://api.newrelic.com/graphiql) para ver mais campos consultáveis. - -## consultar limite padrão [#query-thresholds] - -A seguir está um exemplo de consulta que retorna o [limite](#query-thresholds) padrão atual: - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds { - signalName - domainType { - domain - type - } - deviationSensitivity - upperLimit { - active - value - } - upperRelativePercent { - active - value - } - significantDeviationDirection - lowerRelativePercent { - value - active - } - lowerLimit { - active - value - } - } - } - } -} -``` - -Alguns detalhes sobre esta consulta: - -* **signalName** - - : Uma string que representa um limite global, denominado - - **globalDefault** - - , ou um limite de sinal (por exemplo, "throughput", "errorRate", etc.) - -* **domainType** - - : O limite global não possui um tipo de domínio. - -Se você quiser filtrar os valores limite para um ou mais domainTypes, passe um filtro para a consulta anterior da seguinte forma: - -``` -{ - actor { - anomalyDetectorConfigurations { - anomalyDetectorThresholds(filters: { - domainTypes: [ - { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - } - ] - } - ) - { - signalName - } - } - } -} -``` - -Alguns detalhes sobre partes desta consulta: - -* `domainType.domain`: Uma string que representa um domínio de entidade. -* `domainType.type`: Uma string que representa um tipo de entidade. - -## Validar um sinal NRQL personalizado [#validate-nrql] - -Isto é útil apenas ao criar um detector de anomalia baseado em NRQL. a detecção de anomalias não suporta todos os recursos NRQL. Para evitar erros na criação, você pode primeiro validar a consulta NRQL que planeja usar. Se a sua consulta não for válida, forneceremos uma lista dos motivos. Uma lista vazia indica que sua consulta é válida. - -A seguir está um exemplo de mutação que valida que uma consulta NRQL é totalmente suportada pela detecção de anomalias: - -``` -mutation { - anomalyDetectorConfigurationsValidateNrqlSignal( - accountId: ACCOUNT_ID, - nrql: "NRQL" - ) { - invalidNrqlReasons - } -} -``` - -Alguns detalhes sobre esta mutação: - -* `accountId`: O accountId sendo consultado. -* `nrql`: Uma [consulta NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/). - -Razões pelas quais sua consulta pode ser inválida: - -* `CASES_NOT_SUPPORTED` - Os casos não são suportados. -* `COMPARE_WITH_NOT_SUPPORTED` - A cláusula COMPARE WITH não é suportada. -* `COULDNT_COMPLETE_QUERY` - A consulta retornou muitos dados para suporte de detecção de anomalia. -* `DAQS_NOT_ALLOWED` - A consulta não é suportada pelo DAQS. -* `INVALID_NRQL` - A consulta é inválida. -* `LIMIT_NOT_SUPPORTED` - A cláusula LIMIT não é suportada. -* `MISSING_FACET` - Falta um valor de atributo na consulta. -* `MULTIPLE_FACET_NOT_SUPPORTED` - Atributo de múltiplas facetas por consulta não é suportado. -* `MULTISELECT_NOT_SUPPORTED` - Várias cláusulas SELECT não são suportadas. -* `NON_NUMERIC_AGGREGATE_NOT_SUPPORTED` - consultas que retornam valores não numéricos não são suportadas. -* `NOT_AUTHORIZED` - O usuário não tem acesso à conta fornecida. -* `SINCE_NOT_SUPPORTED` - A cláusula SINCE não é suportada. -* `TIMESERIES_NOT_SUPPORTED` - A cláusula TIMESERIES não é suportada. -* `TOO_MANY_FACET_VALUES` - A consulta ultrapassou o limite da faceta de detecção de anomalias. -* `UNTIL_NOT_SUPPORTED` - A cláusula UNTIL não é suportada. - -## Limite do detector de anomalias - -Um limite é um grupo de configurações que representa os limites superior e/ou inferior que indicam quando um sinal é considerado anômalo. Quando a configuração de anomalia do detector é criada, eles passam a usar as configurações padrão adequadas para a maioria dos detectores. - -#### Limite de consulta [#query-thresholds] - -Existem dois tipos de valores padrão, um único limite global e um limite de sinal. Ao consultar o limite associado a um detector de anomalia, um valor nulo dentro de `WorkloadAnomalyDetector` ou `EntityTypeAnomalyDetector` indica que um valor padrão de sinal está sendo usado. - -Um valor nulo em um NrqlAnomalyDetector indica que o valor padrão global está sendo usado. Esses valores padrão estão sujeitos a alterações ao longo do tempo - use nossa [consulta de limite](#query-thresholds) para obter os valores padrão mais recentes. - -#### Limite de atualização [#update-thresholds] - -Você pode fazer alterações para limitar qualquer alteração de edição de configuração. workload e a configuração do tipo de entidade possuem uma lista de limites, um por sinais clássicos por tipo de entidade (a carga de trabalho pode conter vários tipos de entidade). - -A configuração NRQL possui um único limite por sinal customizado. A seguir está um exemplo de objeto limite usado para atualizar valores limite em qualquer [mutação de atualização](#update-configuration). - -``` -{ - signalName: "SIGNAL_NAME", - domainType: { - domain: "ENTITY_DOMAIN", - type: "ENTITY_TYPE" - }, - deviationSensitivity: DEVIATION_SENSITIVITY, - significantDeviationDirection: SIGNIFICANT_DEVIATION_DIRECTION, - upperLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - upperRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - }, - lowerLimit: { - value: LIMIT_VALUE, - active: STATUS - }, - lowerRelativePercent: { - value: PERCENT_VALUE, - active: STATUS - } -} -``` - -Alguns detalhes sobre este tipo: - -* `signalName`: O nome do sinal. _Para configuração NRQL , esse nome deve corresponder a `nrqlSignal.name`_. -* `domainType`: Será nulo para sinais NRQL personalizados. -* `domain`: Uma string que representa um domínio de entidade. -* `type`: Uma string que representa um tipo de entidade. -* `deviationSensitivity`: Opcional. O nível de sensibilidade para determinar quais dados são anômalos. As opções de valor são: - - -* `NONE` - Sem anomalia. -* `LOW` - Menos anomalia. Por exemplo, você pode decidir que o uso da CPU do seu host está produzindo muitas anomalias e você gostaria de menos. -* `MEDIUM` - Alguma anomalia. -* `HIGH` - Mais anomalia. Por exemplo, você pode decidir que a taxa de erros do seu serviço está produzindo poucas anomalias e você gostaria de mais. - - -* `significantDeviationDirection`: Opcional. A direção significativa para determinar qual direção de mudança é relevante para um sinal. As opções de valor são: - - -* `HIGHER` - Anômalo quando a mudança relativa é maior. Por exemplo, você pode decidir que uma taxa de erros para o seu serviço só é anômala quando aumenta. -* `HIGHER_LOWER` - Anômalo quando a mudança relativa é maior ou menor. -* `LOWER` - Anômalo quando a mudança relativa é menor. Por exemplo, você pode decidir que as taxas de transferência do seu serviço só serão anômalas quando ele cair. - - -* `upperLimit`: Opcional. Um limite superior estático. Qualquer valor acima deste valor limite será considerado anômalo quando a direção significativa do Desvio for `HIGHER` ou `HIGHER_LOWER`. -* `value`: Opcional. Um valor numérico. -* `active`: Opcional. Verdadeiro ou falso. -* `upperRelativePercent`: Opcional. Qualquer alteração percentual relativa superior a esse valor percentual será considerada anômala quando a direção significativa do Desvio for `HIGHER` ou `HIGHER_LOWER`. -* `value`: Opcional. Um valor numérico. -* `active`: Opcional. Verdadeiro ou falso. -* `lowerLimit`: Opcional. Um limite inferior estático. Qualquer valor abaixo deste valor limite será considerado anômalo quando a direção significativa do Desvio for `LOWER` ou `HIGHER_LOWER`. -* `value`: Opcional. Um valor numérico. -* `active`: Opcional. Verdadeiro ou falso. -* `lowerRelativePercent`: Opcional. Qualquer alteração percentual relativa inferior a esse valor percentual será considerada anômala quando a direção significativa do Desvio for `LOWER` ou `HIGHER_LOWER`. -* `value`: Opcional. Um valor numérico. -* `active`: Opcional. Verdadeiro ou falso. \ No newline at end of file