Creates a new health rule from the specified JSON payload. See Property Details.

Resource URL

Request/Response Format

JSON

Example

This example creates a health rule with an affected entity type business transaction performance and defines the evaluation criteria for the health rule. See Download Examples.

Request

{
  "name": "My new health rule",
  "enabled": true,
  "useDataFromLastNMinutes": 30,
  "waitTimeAfterViolation": 5,
  "affects": {
    "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
    "affectedBusinessTransactions": {
      "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
    }
  },
  "evalCriterias": {
    "criticalCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evaluateToTrueOnNoData": false,
          "evalDetail": {
            "evalDetailType": "SINGLE_METRIC",
            "metricAggregateFunction": "VALUE",
            "metricPath": "Average CPU Used (ms)",
            "metricEvalDetail": {
              "metricEvalDetailType": "BASELINE_TYPE",
              "baselineCondition": "WITHIN_BASELINE",
              "baselineName": "All Data - Last 15 Days",
              "baselineUnit": "PERCENTAGE",
              "compareValue": 30.5
            }
          }
        }
      ]
    },
    "warningCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evalDetail": {
            "evalDetailType": "METRIC_EXPRESSION",
            "metricExpression": "({metric1} + ({metric2} * 3))",
            "metricExpressionVariables": [
              {
                "variableName": "metric1",
                "metricAggregateFunction": "VALUE",
                "metricPath": "95th Percentile Response Time (ms)"
              },
              {
                "variableName": "metric2",
                "metricAggregateFunction": "MAXIMUM",
                "metricPath": "Average CPU Used (ms)"
              }
            ],
            "metricEvalDetail": {
              "metricEvalDetailType": "SPECIFIC_TYPE",
              "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
              "compareValue": 10
            }
          }
        }
      ]
    }
  }
}

Response

{
    "id": 26,
    "name": "My new health rule",
    "enabled": false,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 5,
    "scheduleName": "Weeknights: 11pm-6am, Mon-Fri",
    "affects": {
        "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
        "affectedBusinessTransactions": {
            "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Average CPU Used (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "BASELINE_TYPE",
                            "baselineCondition": "WITHIN_BASELINE",
                            "baselineName": "All data - Last 15 days",
                            "compareValue": 30.5,
                            "baselineUnit": "PERCENTAGE"
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "METRIC_EXPRESSION",
                        "metricExpression": "({metric1} + ({metric2} * 3))",
                        "metricExpressionVariables": [
                            {
                                "variableName": "metric1",
                                "metricAggregateFunction": "VALUE",
                                "metricPath": "95th Percentile Response Time (ms)"
                            },
                            {
                                "variableName": "metric2",
                                "metricAggregateFunction": "MAXIMUM",
                                "metricPath": "Average CPU Used (ms)"
                            }
                        ],
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 10
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        }
    }
}

This API returns a list of all the health rule IDs and names for the specified application ID. To retrieve complete details of the health rule, use GET //health-rule/{health-rule-id}. See Property Details.

Resource URL

Response Format

JSON

Example Response

[
    {
        "id": 1,
        "name": "Machine Availability is too low",
        "enabled": true
    },
    {
        "id": 2,
        "name": "Overall Disk Space Available is too low",
        "enabled": true
    },
    {
        "id": 3,
        "name": "CPU Usage is too high",
        "enabled": true
    },
    {
        "id": 4,
        "name": "Memory Usage is too high",
        "enabled": true
    },
    {
        "id": 5,
        "name": "Swap Usage is too high",
        "enabled": true
    },
    {
        "id": 6,
        "name": "Disk Usage is too high on at least one partition",
        "enabled": false
    }
]

This API Returns the health rule details for the specified health rule ID.

Resource URL

Response Format

JSON

Example Response

{
    "id": 26,
    "name": "My new health rule",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 5,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
        "affectedBusinessTransactions": {
            "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Average CPU Used (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "BASELINE_TYPE",
                            "baselineCondition": "WITHIN_BASELINE",
                            "baselineName": "All data - Last 15 days",
                            "compareValue": 30.5,
                            "baselineUnit": "PERCENTAGE"
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "METRIC_EXPRESSION",
                        "metricExpression": "({metric1} + ({metric2} * 3))",
                        "metricExpressionVariables": [
                            {
                                "variableName": "metric1",
                                "metricAggregateFunction": "VALUE",
                                "metricPath": "95th Percentile Response Time (ms)"
                            },
                            {
                                "variableName": "metric2",
                                "metricAggregateFunction": "MAXIMUM",
                                "metricPath": "Average CPU Used (ms)"
                            }
                        ],
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 10
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        }
    }
}

This API updates an existing health rule (required fields) with details from the specified health rule ID. See Property Details.

Resource URL

Request/Response Format

JSON

Example

Request

{
  "name": "My new health rule",
  "enabled": true,
  "useDataFromLastNMinutes": 30,
  "waitTimeAfterViolation": 5,
  "affects": {
    "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
    "affectedBusinessTransactions": {
      "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
    }
  },
  "evalCriterias": {
    "criticalCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evaluateToTrueOnNoData": false,
          "evalDetail": {
            "evalDetailType": "SINGLE_METRIC",
            "metricAggregateFunction": "VALUE",
            "metricPath": "Average CPU Used (ms)",
            "metricEvalDetail": {
              "metricEvalDetailType": "BASELINE_TYPE",
              "baselineCondition": "WITHIN_BASELINE",
              "baselineName": "All Data - Last 15 Days",
              "baselineUnit": "PERCENTAGE",
              "compareValue": 30.5
            }
          }
        }
      ]
    },
    "warningCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evalDetail": {
            "evalDetailType": "METRIC_EXPRESSION",
            "metricExpression": "({metric1} + ({metric2} * 3))",
            "metricExpressionVariables": [
              {
                "variableName": "metric1",
                "metricAggregateFunction": "VALUE",
                "metricPath": "95th Percentile Response Time (ms)"
              },
              {
                "variableName": "metric2",
                "metricAggregateFunction": "MAXIMUM",
                "metricPath": "Average CPU Used (ms)"
              }
            ],
            "metricEvalDetail": {
              "metricEvalDetailType": "SPECIFIC_TYPE",
              "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
              "compareValue": 10
            }
          }
        }
      ]
    }
  }
}

Response

{
  "name": "My new health rule",
  "enabled": true,
  "useDataFromLastNMinutes": 30,
  "waitTimeAfterViolation": 5,
  "affects": {
    "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
    "affectedBusinessTransactions": {
      "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
    }
  },
  "evalCriterias": {
    "criticalCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evaluateToTrueOnNoData": false,
          "evalDetail": {
            "evalDetailType": "SINGLE_METRIC",
            "metricAggregateFunction": "VALUE",
            "metricPath": "Average CPU Used (ms)",
            "metricEvalDetail": {
              "metricEvalDetailType": "BASELINE_TYPE",
              "baselineCondition": "WITHIN_BASELINE",
              "baselineName": "All Data - Last 15 Days",
              "baselineUnit": "PERCENTAGE",
              "compareValue": 30.5
            }
          }
        }
      ]
    },
    "warningCriteria": {
      "conditionAggregationType": "ALL",
      "conditions": [
        {
          "name": "Condition 1",
          "shortName": "A",
          "evalDetail": {
            "evalDetailType": "METRIC_EXPRESSION",
            "metricExpression": "({metric1} + ({metric2} * 3))",
            "metricExpressionVariables": [
              {
                "variableName": "metric1",
                "metricAggregateFunction": "VALUE",
                "metricPath": "95th Percentile Response Time (ms)"
              },
              {
                "variableName": "metric2",
                "metricAggregateFunction": "MAXIMUM",
                "metricPath": "Average CPU Used (ms)"
              }
            ],
            "metricEvalDetail": {
              "metricEvalDetailType": "SPECIFIC_TYPE",
              "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
              "compareValue": 10
            }
          }
        }
      ]
    }
  }
}

Deletes an existing health rule with the specified ID.

Resource URL

This API updates one or more configuration setting(s) of a health rule. See Property Details

You can enter one or both of the following field(s) in the request:

• Enable/disable the health rule.
• Update the schedule of the health rule.

Resource URL

Request/Response Format

JSON

Example

Request

{
  "enabled": "false",
  "scheduleName": "Weeknights: 11pm-6am, Mon-Fri"
}

Response

{
    "id": 26,
    "name": "My new health rule",
    "enabled": false,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 5,
    "scheduleName": "Weeknights: 11pm-6am, Mon-Fri",
    "affects": {
        "affectedEntityType": "BUSINESS_TRANSACTION_PERFORMANCE",
        "affectedBusinessTransactions": {
            "businessTransactionScope": "ALL_BUSINESS_TRANSACTIONS"
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Average CPU Used (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "BASELINE_TYPE",
                            "baselineCondition": "WITHIN_BASELINE",
                            "baselineName": "All data - Last 15 days",
                            "compareValue": 30.5,
                            "baselineUnit": "PERCENTAGE"
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "METRIC_EXPRESSION",
                        "metricExpression": "({metric1} + ({metric2} * 3))",
                        "metricExpressionVariables": [
                            {
                                "variableName": "metric1",
                                "metricAggregateFunction": "VALUE",
                                "metricPath": "95th Percentile Response Time (ms)"
                            },
                            {
                                "variableName": "metric2",
                                "metricAggregateFunction": "MAXIMUM",
                                "metricPath": "Average CPU Used (ms)"
                            }
                        ],
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 10
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        }
    }
}

Enables all the health rules of an application.

Resource URL

Disable all the health rules of an application.

Resource URL

HealthRule

HealthRuleSummaryArray

HealthRuleConfiguration

正常性ルールの JSON ペイロード全体を送信する必要なく、個別に更新できる正常性ルールの構成詳細。1 つ以上のプロパティを指定することができ、それらのプロパティはすべて新しい指定値に設定されます。

MetricEvalDetail

BaselineMetricEvalDetail

正常性ルールを評価するために使用されるベースラインからのメトリックの偏差。

SpecificValueMetricEvalDetail

正常性ルールを評価するために使用される特定値からのメトリックの偏差。

MetricAggregateFunction

偏差を判別して正常性ルールを評価するために集約されたメトリック。

SingleMetricEvalDetail

正常性ルールを評価するために使用される「集約値」からの単一メトリックの偏差。

Application Infrastructure Performance|Root\\|Containers\\|Fulfillment-Service|Individual Nodes|9b711cda4a83|Hardware Resources|CPU|%Busy

MetricExpressionEvalDetail

正常性ルールを評価するために使用されるメトリック式。

MetricDetailWithVariableName

NodeEvalMatchingCriteria

状態

true または false に個別に評価できる単一の条件。条件のリスト（最大 8 つ）と、基準を形成するための他のプロパティ。

ConditionEvalDetail

基準

EntityMatchingPattern

AffectedTiers

AllTiers

影響を受ける階層の範囲は、影響を受けるエンティティのすべての階層に設定されます。

SpecificTiers

影響を受ける階層の範囲は、影響を受けるエンティティの特定の階層に設定されます。

TiersByTags

影響を受ける階層の範囲が、タグ条件に一致するすべての階層に設定されます。

AffectedNodes

AffectedNodes

AllNodes

影響を受けるノードの範囲は、影響を受けるエンティティのすべてのノードに設定されます。

SpecificNodes

影響を受けるノードの範囲は、影響を受けるエンティティのすべてのノードに設定されます。

NodesOfSpecificTiers

影響を受けるノードの範囲は、影響を受けるエンティティの特定の階層のノードに設定されます。

NodesMatchingPattern

影響を受けるノードの範囲は、影響を受けるエンティティのパターンに一致するノードに設定されます。

NodePropertyVariableMatcher

影響を受けるノードの範囲は、影響を受けるエンティティの変数のプロパティと一致するノードに設定されます。

OverallApplicationPerformance

影響を受けるエンティティの範囲は、全体的なアプリケーション パフォーマンスに設定されます。

BusinessTransactionPerformance

影響を受けるエンティティの範囲は、ビジネス トランザクション パフォーマンスに設定されます。

AffectedBusinessTransactions

AllBusinessTransactions

ビジネストランザクションの範囲が、すべてのビジネストランザクションに設定されます。

SpecificBusinessTransactions

ビジネストランザクションの範囲は、特定のビジネストランザクションに設定されます。

BusinessTransactionsInSpecificTiers

ビジネストランザクションの範囲は、特定の階層のビジネストランザクションに設定されます。

BusinessTransactionsMatchingPattern

ビジネストランザクションの範囲は、特定のパターンに一致するビジネストランザクションに設定されます。

BUSINESS_TRANSACTIONS_BY_TAGS

ビジネストランザクションの範囲が、タグによってビジネストランザクションに設定されます。

TierNodeTransactionPerformance

影響を受けるエンティティのタイプは、階層およびノードトランザクションのパフォーマンスに設定されます。

AffectedTierOrNodeEntities

TierAffectedEntities

影響を受けるエンティティの範囲は、階層に設定されます。

NodeAffectedEntities

影響を受けるエンティティの範囲は、ノードに設定されます。

TierNodeHardware

影響を受けるエンティティタイプは、階層ノードハードウェアに設定されます。

ServersInApplication

影響を受けるエンティティタイプは、servers in the application に設定されます。

ApplicationAffectedServers

AllServersInApplication

サーバの範囲は、アプリケーション内のすべてのサーバに設定されます。

SpecificServersInApplication

サーバの範囲は、アプリケーション内の特定のサーバに設定されます。

AllServersInSpecificTiers

サーバの範囲は、特定の階層内のすべてのサーバに設定されます。

ApmServersByTags

サーバーの範囲が、タグ条件に一致するすべてのサーバーに設定されます。

バックエンド

影響を受けるエンティティタイプは、バックエンドに設定されます。

AffectedBackends

AllBackends

バックエンドの範囲は、すべてのバックエンドに設定されます。

SpecificBackends

バックエンドの範囲は、特定のバックエンドに設定されます。

BackendsMatchingPattern

バックエンドの範囲は、特定のパターンに一致するバックエンドに設定されます。

エラー

影響を受けるエンティティタイプは、エラーに設定されます。

AffectedErrors

AllErrors

エラーの範囲は、すべてのエラーに設定されます。

SpecificErrors

エラーの範囲は、特定のエラーに設定されます。

{
"id": 33,
"name": "Specific Error",
"enabled": true,
"useDataFromLastNMinutes": 1,
"waitTimeAfterViolation": 1,
"scheduleName": "Always",
"affects": {
"affectedEntityType": "ERRORS",
"affectedErrors": {
"errorScope": "SPECIFIC_ERRORS",
"errors": [
"Page Not Found : 404", "Error2"
],
"tiers": [
"Tier1", "SomeOtherTier"
]
}
},
"evalCriterias": {
"criticalCriteria": {
"conditionAggregationType": "ALL",
"conditionExpression": null,
"conditions": [
{
"name": "Condition 1",
"shortName": "A",
"evaluateToTrueOnNoData": false,
"evalDetail": {
"evalDetailType": "SINGLE_METRIC",
"metricAggregateFunction": "VALUE",
"metricPath": "Errors per Minute",
"metricEvalDetail": {
"metricEvalDetailType": "SPECIFIC_TYPE",
"compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
"compareValue": 10
}
},
"triggerEnabled": false,
"minimumTriggers": 1
}
],
"evalMatchingCriteria": {
"matchType": "ANY_NODE",
"value": null
}
},
"warningCriteria": null
}
}

ErrorsOfSpecificTiers

エラーの範囲は、特定の階層に関連するエラーに設定されます。

ErrorsMatchingPattern

エラーの範囲は、特定のパターンに一致するエラーに設定されます。

ServiceEndpoints

影響を受けるエンティティタイプは、サービスエンドポイントに設定されます。

AffectedServiceEndpoints

AllServiceEndpoints

サービスエンドポイントの範囲は、すべてのサービスエンドポイントに設定されます。

SpecificServiceEndpoints

サービスエンドポイントの範囲は、特定のサービスエンドポイントに設定されます。

ServiceEndpointsInSpecificTiers

サービスエンドポイントの範囲は、特定のサービスエンドポイントに設定されます。

ServiceEndpointsMatchingPattern

サービスエンドポイントの範囲は、特定のパターンに一致するサービスエンドポイントに設定されます。

InformationPoints

影響を受けるエンティティタイプは、情報ポイントに設定されます。

AffectedInformationPoints

AllInformationPoints

情報ポイントの範囲は、すべての情報ポイントに設定されます。

SpecificInformationPoints

情報ポイントの範囲は、特定の情報ポイントに設定されます。

InformationPointsMatchingPattern

情報ポイントの範囲は、パターンに一致する情報ポイントに設定されます。

カスタム

影響を受けるエンティティタイプは、カスタムに設定されます。

AffectedEntityScope

ApplicationPerformance

影響を受けるエンティティの範囲は、アプリケーション パフォーマンスに設定されます。

SpecificEntityPerformance

影響を受けるエンティティの範囲は、特定のエンティティパフォーマンスに設定されます。

データベース

影響を受けるエンティティタイプは、データベースに設定されます。

AffectedDatabases

AllDatabases

影響を受けるデータベースの範囲は、すべてのデータベースに設定されます。

SpecificDatabases

影響を受けるデータベースの範囲は、特定のデータベースに設定されます。

DbServer

サーバー

影響を受けるエンティティタイプは、サーバに設定されます。

AffectedServersCriteria

AffectedServers

ServerSelectionCriteria

AllServersInAccount

サーバの範囲は、アカウント内のすべてのサーバに設定されます。

ServersWithinSubGroup

サーバの範囲は、サブグループ内のすべてのサーバに設定されます。

SpecificServers

サーバの範囲は、特定のサーバに設定されます。

ServersMatchingPattern

サーバの範囲は、特定のパターンに一致するサーバに設定されます。

ServersByTags

影響を受けるサーバーの範囲が、タグ条件と一致するサーバーになります。

AffectedServerSubGroups

影響を受けるサーバの範囲は、サブグループ内の影響を受けるサーバに設定されます。

AffectedSubGroups

AllSubGroups

影響を受けるサーバの範囲は、すべてのサブグループ内のサーバに設定されます。

SpecificServerSubGroups

影響を受けるサーバーの範囲は、servers within specific subgroups に設定されます。

AffectedEumBrowserEntities

正常性ルールが影響を与えることができるエンドユーザーモニタリング（EUM）ブラウザエンティティについて説明します。

EumPages

正常性ルールがモニターできるエンドユーザーモニタリング（EUM）ページについて説明します。

AllPages

影響を受けるページの範囲が、すべてのページに設定されます。

SpecificPages

影響を受けるページの範囲が、特定のページに設定されます。

PagesMatchingPattern

影響を受けるページの範囲が、パターンに一致するページに設定されます。

PagesByTags

影響を受けるページの範囲が、タグ条件に一致するページに設定されます。

JMX

影響を受けるエンティティタイプは、JMX に設定されます。

影響を受ける JMX インスタンス

影響を受ける JMX インスタンスの範囲は、すべての JMX インスタンスと特定の JMX インスタンスに設定されます。

すべての JMX インスタンス

JMX インスタンスの範囲は、エンティティのすべての JMX インスタンスに設定されます。

特定の JMX インスタンス

影響を受ける JMX インスタンスの範囲は、エンティティの特定の JMX インスタンスに設定されます。

HealthRuleSummary

ErrorResponse

*このプロパティは必須です。

正常性ルール health_rule_request_examples.zip を設定するのに役立つ一連の例をダウンロードします。

例：タグを使用した正常性ルール

次のセクションでは、タグを使用した正常性ルールに関連するいくつかの例を示します。

タグを使用した階層の正常性ルールの作成

この例では、タグ条件に一致する影響を受けるエンティティタイプ TIER_NODE_TRANSACTION_PERFORMANCE を使用して正常性ルールを作成します。

Resource URL

POST <controller_url>/controller/alerting/rest/v1/applications/10/health-rules

リクエスト

{
    "name": "Health rule for tiers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "TIER_NODE_TRANSACTION_PERFORMANCE",
        "affectedEntities": {
            "tierOrNode": "TIER_AFFECTED_ENTITIES",
            "affectedTiers": {
                "affectedTierScope": "TIERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
 
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Calls per Minute",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 11
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": null
    }
}

レスポンス

{
    "id": 63,
    "name": "Health rule for tiers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "TIER_NODE_TRANSACTION_PERFORMANCE",
        "affectedEntities": {
            "tierOrNode": "TIER_AFFECTED_ENTITIES",
            "affectedTiers": {
                "affectedTierScope": "TIERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Calls per Minute",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 11
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": null
    }
}

タグを使用した階層の正常性ルールの取得

この例では、タグを使用して階層の正常性を取得します。

Resource URL

 GET <controller_url>/controller/alerting/rest/v1/applications/10/health-rules/63

{
    "id": 63,
    "name": "Health rule for tiers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "TIER_NODE_TRANSACTION_PERFORMANCE",
        "affectedEntities": {
            "tierOrNode": "TIER_AFFECTED_ENTITIES",
            "affectedTiers": {
                "affectedTierScope": "TIERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Calls per Minute",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 11
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": {
                "matchType": "ANY_NODE",
                "value": null
            }
        },
        "warningCriteria": null
    }
}

タグを使用したサーバーの正常性ルールの作成

この例では、タグを使用してサーバーの正常性を作成します。

Resource URL

 POST <controller_url>/controller/alerting/rest/v1/applications/3/health-rules/

リクエスト

{
    "name": "Health rule for servers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "SERVERS",
        "serverSelectionCriteria": {
            "selectServersBy": "AFFECTED_SERVERS",
            "affectedServers": {
                "severSelectionScope": "SERVERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Hardware Resources|CPU|%Busy",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 5
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}

レスポンス

{
    "id": 64,
    "name": "Health rule for servers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "SERVERS",
        "serverSelectionCriteria": {
            "selectServersBy": "AFFECTED_SERVERS",
            "affectedServers": {
                "severSelectionScope": "SERVERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Hardware Resources|CPU|%Busy",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 5
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}

タグを使用したサーバーの正常性ルールの取得

この例では、タグを使用してサーバーの正常性を取得します。

Resource URL

 GET <controller_url>/controller/alerting/rest/v1/applications/3/health-rules/64

{
    "id": 64,
    "name": "Health rule for servers with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 30,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "SERVERS",
        "serverSelectionCriteria": {
            "selectServersBy": "AFFECTED_SERVERS",
            "affectedServers": {
                "severSelectionScope": "SERVERS_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Hardware Resources|CPU|%Busy",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 5
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 0
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}

タグを使用したベースページの正常性ルールの作成

この例では、タグを使用してベースページの正常性を作成します。

Resource URL

 POST <controller_url>/controller/alerting/rest/v1/applications/16/health-rules/

リクエスト

{
    "name": "Health rule for base pages with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 1,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "EUM_BROWSER_APPS",
        "affectedEntities": {
            "affectedEumEntityType": "EUM_PAGES",
            "affectedPages": {
                "affectedPageScope": "PAGES_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "violationStatusOnNoData": "UNKNOWN",
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Application Server Time (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 1
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 1
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}                     

レスポンス

{
    "id": 37,
    "name": "Health rule for base pages with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 1,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "EUM_BROWSER_APPS",
        "affectedEntities": {
            "affectedEumEntityType": "EUM_PAGES",
            "affectedPages": {
                "affectedPageScope": "PAGES_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "violationStatusOnNoData": "UNKNOWN",
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Application Server Time (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 1
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 1
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}                   

タグを使用したベースページの正常性ルールの取得

この例では、タグを使用したベースページの正常性を取得します。

Resource URL

 GET <controller_url>/controller/alerting/rest/v1/applications/16/health-rules/37

{
    "id": 37,
    "name": "Health rule for base pages with tags",
    "enabled": true,
    "useDataFromLastNMinutes": 1,
    "waitTimeAfterViolation": 30,
    "scheduleName": "Always",
    "affects": {
        "affectedEntityType": "EUM_BROWSER_APPS",
        "affectedEntities": {
            "affectedEumEntityType": "EUM_PAGES",
            "affectedPages": {
                "affectedPageScope": "PAGES_BY_TAGS",
                "tagVarPairs": [
                    {
                        "propertyType": "TAG",
                        "name": "i_app_support_org",
                        "value": "Enterprise Platforms"
                    },
                    {
                        "propertyType": "TAG",
                        "name": "i_manufacturer",
                        "value": "Cisco"
                    }
                ]
            }
        }
    },
    "evalCriterias": {
        "criticalCriteria": {
            "conditionAggregationType": "ALL",
            "conditionExpression": null,
            "conditions": [
                {
                    "name": "Condition 1",
                    "shortName": "A",
                    "evaluateToTrueOnNoData": false,
                    "violationStatusOnNoData": "UNKNOWN",
                    "evalDetail": {
                        "evalDetailType": "SINGLE_METRIC",
                        "metricAggregateFunction": "VALUE",
                        "metricPath": "Application Server Time (ms)",
                        "metricEvalDetail": {
                            "metricEvalDetailType": "SPECIFIC_TYPE",
                            "compareCondition": "GREATER_THAN_SPECIFIC_VALUE",
                            "compareValue": 1
                        }
                    },
                    "triggerEnabled": false,
                    "minimumTriggers": 1
                }
            ],
            "evalMatchingCriteria": null
        },
        "warningCriteria": null
    }
}