ServiceHealthBehavior クラス

定義

public ref class ServiceHealthBehavior : System::ServiceModel::Description::ServiceHealthBehaviorBase

public class ServiceHealthBehavior : System.ServiceModel.Description.ServiceHealthBehaviorBase

type ServiceHealthBehavior = class
    inherit ServiceHealthBehaviorBase

Public Class ServiceHealthBehavior
Inherits ServiceHealthBehaviorBase

継承

Object

ServiceHealthBehaviorBase

ServiceHealthBehavior

注釈

正常性エンドポイントは、コンポーネントの正常性を評価する正常性チェックを実行するために使用されます。 正常性エンドポイントは、次の目的で使用できます。

• 重大な正常性チェックに失敗しているプロセスを強制終了するようにオーケストレーション ツールに通知します。

• サービスの可用性とパフォーマンスに関するアラートを追跡して提供することで、ツールを監視するための早期の問題インジケーターとして機能します。

ServiceHealthBehavior は、IServiceBehavior を拡張し、 ServiceHealthBehaviorBaseから派生する WCF サービス動作です。 ServiceHealthBehavior コレクションにServiceDescription.Behaviors インスタンスを追加すると、次のことが可能になります。

• サービス正常性の公開: サービスの状態、スロットル数、容量などのサービス固有の詳細は、http/GET 要求と ?health クエリ文字列を使用して表示できます。 表示される情報を把握し、簡単にアクセスすることは、不適切な動作をする WCF サービスをトラブルシューティングする際に最も重要です。

• HTTP 応答コードの戻り値: クエリ文字列で、HTTP/GET 正常性プローブ要求の HTTP 状態コードを指定できます。

正常性エンドポイントは、正常性を監視するコンポーネントのコンテキストでのみ意味があります。 他の意味や目的はありません。 そのため、その正常性は、コンポーネントの正常性への導管です。 クライアントは、正常性エンドポイントによって返される HTTP 応答コードがコンポーネント全体に適用されると想定する 必要があります 。 これは、ロード バランサー、サービス検出など、正常性チェックを利用する現在のインフラストラクチャ ツールで想定される動作と互換性があります。

正常性エンドポイントを有効にする

正常性エンドポイントを公開し、WCF サービスの正常性情報を公開する方法を指定するには、次の 2 つの方法があります。

• 構成ファイルを使用する。 例えば次が挙げられます。

  <behaviors>
     <serviceBehaviors>
       <behavior name="DefaultBehavior">
         <serviceHealth httpGetEnabled="true"/>
       </behavior>
     </serviceBehaviors>
  </behaviors>
  

• プログラムによって自動的に。 次のコード フラグメントでは、C# を使用して正常性エンドポイントを公開しています。

  ServiceHost host = new ServiceHost(typeof(Service1),
      new Uri("http://jconde-dev1:81/Service1"));
  ServiceHealthBehavior healthBehavior =
              host.Description.Behaviors.Find<ServiceHealthBehavior>();
  if (healthBehavior == null)
  {
      healthBehavior = new ServiceHealthBehavior();
  }
  //healthBehavior.HttpGetEnabled = false;
  //healthBehavior.HttpsGetEnabled = false;
  host.Description.Behaviors.Add(healthBehavior);