Azure Data Factory の統合ランタイムを監視する

適用対象: Azure Data Factory Azure Synapse Analytics

統合ランタイムは、異なるネットワーク環境間のさまざまなデータ統合機能を提供するために Azure Data Factory (ADF) によって使われるコンピューティング インフラストラクチャです。 3 種類の統合ランタイムが Data Factory によって提供されています。

• Azure 統合ランタイム
• セルフホステッド統合ランタイム
• Azure-SQL Server Integration Services (SSIS) 統合ランタイム

統合ランタイム (IR) のインスタンスの状態を取得するには、次の PowerShell コマンドを実行します。

Get-AzDataFactoryV2IntegrationRuntime -DataFactoryName MyDataFactory -ResourceGroupName MyResourceGroup -Name MyAzureIR -Status

コマンドレットは、統合ランタイムの種類ごとに異なる情報を返します。 この記事では、統合ランタイムの種類ごとにプロパティと状態を説明します。

Azure 統合ランタイム

Azure 統合ランタイムのコンピューティング リソースは、Azure で完全かつ柔軟に管理されます。 次の表では、Get-AzDataFactoryV2IntegrationRuntime コマンドによって返されるプロパティについて説明します。

プロパティ

次の表では、Azure 統合ランタイム用のコマンドレットによって返されるプロパティについて説明します。

ステータス

次の表では、Azure 統合ランタイムの状態を示します。

セルフホステッド インテグレーション ランタイム

このセクションでは、Get-AzDataFactoryV2IntegrationRuntime コマンドレットによって返されるプロパティについて説明します。

プロパティ

次の表では、各ノードの監視プロパティについて説明します。

プロパティの一部の設定は、セルフホステッド統合ランタイムに複数のノードがあるとき (つまり、スケール アウト シナリオで)、より大きな意味を持つようになります。

同時実行ジョブの上限

同時実行ジョブの上限の既定値は、コンピューターのサイズに基づいて設定されます。 この値の計算に使用される要素は、コンピューターの RAM 量と CPU コア数によって変わります。 コアやメモリが多ければ多いほど、同時実行ジョブの既定の上限が高くなります。

ノード数を増やすことでスケールアウトします。 ノード数を増やすとき、同時実行ジョブの上限は、利用可能なすべてのノードの同時実行ジョブ上限値を足したものになります。 たとえば、1 ノードで最大 12 のジョブを同時実行できる場合、同じようなノードを 3 つ追加すると、(4 x 12 で) 最大 48 のジョブを同時実行できます。 既定値では各ノードのリソース使用率が低い場合にのみ、同時実行ジョブの上限を増やすことをお勧めします。

算出された既定値は Azure Portal でオーバーライドできます。 [作成者] > [接続] > [統合ランタイム] > [編集] > [ノード] > [Modify concurrent job value per node](ノード別の同時実行ジョブ値を変更する) の順に選びます。 PowerShell update-Azdatafactoryv2integrationruntimenode コマンドを使用することもできます。

状態 (ノードごと)

次の表では、セルフホステッド統合ランタイムのノードの状態を示します。

他のノードに接続できない場合、ノードが非アクティブになることがあります。

状態（セルフホスト型統合ランタイム全体）

次の表では、セルフホステッド統合ランタイムの状態を示します。 この状態は、ランタイムに属しているすべてのノードの状態によって決まります。

セルフホステッド統合ランタイムのプロパティの詳細と、コマンドレット実行時のプロパティのスナップショット値を含む JSON ペイロードをフェッチするには、Get-AzDataFactoryV2IntegrationRuntimeMetric コマンドレットを使います。

Get-AzDataFactoryV2IntegrationRuntimeMetric -name $integrationRuntimeName -ResourceGroupName $resourceGroupName -DataFactoryName $dataFactoryName | ConvertTo-Json 

サンプル出力 (このセルフホステッド統合ランタイムには 2 つのノードが関連付けられているものとします):

{
	"IntegrationRuntimeName":  "<Name of your integration runtime>",
    "ResourceGroupName":  "<Resource Group Name>",
    "DataFactoryName":  "<Data Factory Name>",
    "Nodes":  [
		{
			"NodeName":  "<Node Name>",
			"AvailableMemoryInMB":  <Value>,
			"CpuUtilization":  <Value>,
			"ConcurrentJobsLimit":  <Value>,
			"ConcurrentJobsRunning":  <Value>,
			"MaxConcurrentJobs":  <Value>,
			"SentBytes":  <Value>,
			"ReceivedBytes":  <Value>
		},
		{
			"NodeName":  "<Node Name>",
			"AvailableMemoryInMB":  <Value>,
			"CpuUtilization":  <Value>,
			"ConcurrentJobsLimit":  <Value>,
			"ConcurrentJobsRunning":  <Value>,
			"MaxConcurrentJobs":  <Value>,
			"SentBytes":  <Value>,
			"ReceivedBytes":  <Value>
		}

	]
} 

Azure-SSIS 統合ランタイム

Azure-SSIS IR は、SSIS パッケージ実行専用の Azure 仮想マシン (VM またはノード) の、フル マネージドのクラスターです。 さまざまな方法を使用して、Azure-SSIS IR 上での SSIS パッケージの実行を呼び出すことができます。たとえば、Azure 対応 SQL Server Data Tools (SSDT)、AzureDTExec コマンド ライン ユーティリティ、SQL Server Management Studio (SSMS) または SQL Server エージェントでの T-SQL、ADF パイプラインでの SSIS パッケージの実行アクティビティなどがあります。 Azure-SSIS IR では、その他の ADF アクティビティは実行されません。 プロビジョニングが完了すると、Azure PowerShell、Azure portal、および Azure Monitor を介して、全体またはノード固有のプロパティと状態を監視できます。

Azure PowerShell を使用して Azure-SSIS Integration Runtime を監視する

次の Azure PowerShell コマンドレットを使用して、Azure-SSIS IR の全体またはノード固有のプロパティと状態を監視します。

Get-AzDataFactoryV2IntegrationRuntime -DataFactoryName $DataFactoryName -Name $AzureSSISName -ResourceGroupName $ResourceGroupName -Status

プロパティ

次の表では、Azure-SSIS IR 用の上記のコマンドレットによって返されるプロパティについて説明します。

状態 (Azure-SSIS IR ノード単位)

次の表では、Azure-SSIS IR ノードの可能な状態を示します。

Azure-SSIS IR 全体の状態

次の表では、Azure-SSIS IR 全体の可能な状態を示します。 全体的な状態は、Azure-SSIS IR に属するすべてのノードの状態の組み合わせに応じて異なります。

Azure portal で Azure-SSIS Integration Runtime を監視する

Azure portal で Azure-SSIS IR を監視するには、ADF UI の [監視] ハブの [統合ランタイム] ページに移動します。そこでは、すべての統合ランタイムを確認できます。

次に、Azure-SSIS IR の名前を選択して監視ページを開きます。そこでは、全体またはノード固有のプロパティと状態を確認できます。 このページには、Azure-SSIS IR の全般、デプロイ、および詳細の設定の構成方法に応じて、さまざまな情報や機能のタイルが表示されます。

[種類] と [リージョン] の各情報タイルには、Azure-SSIS IR の種類とリージョンがそれぞれ表示されます。

[ノード サイズ] 情報タイルには、Azure-SSIS IR の SKU (SSIS edition_VM tier_VM シリーズ)、CPU コア数、ノードあたりの RAM のサイズが表示されます。

[RUNNING / REQUESTED NODE(S)](実行中または要求されたノード) 情報タイルでは、現在実行中のノード数が、Azure-SSIS IR に対して以前に要求されたノードの合計数と比較されます。

[DUAL STANDBY PAIR / ROLE](デュアル スタンバイ ペアまたはロール) 情報タイルには、事業継続とディザスター リカバリー (BCDR) のために Azure SQL Managed Instance フェールオーバー グループと同期して機能するデュアル スタンバイ Azure-SSIS IR ペアの名前と、Azure-SSIS IR の現在のプライマリおよびセカンダリ ロールが表示されます。 SSISDB フェールオーバーが発生すると、プライマリとセカンダリの Azure-SSIS IR のロールが入れ替わります (BCDR 用の Azure-SSIS IR の構成に関する記事を参照)。

機能タイルの詳細については、以下を参照してください。

ステータス タイル

Azure-SSIS IR 監視ページの [状態] タイルには、 [実行中] や [停止済み] など、全体的な状態が表示されます。 [実行中] という状態を選択すると、Azure-SSIS IR を停止するライブの [停止] ボタンがあるウィンドウがポップアップ表示されます。 [停止済み] という状態を選択すると、Azure-SSIS IR を開始するライブの [開始] ボタンがあるウィンドウがポップアップ表示されます。 ポップアップ ウィンドウには、Azure-SSIS IR 上で実行される [SSIS パッケージの実行] アクティビティを含む ADF パイプラインを自動生成する [SSIS パッケージの実行] ボタン (ADF パイプラインでの [SSIS パッケージの実行] アクティビティとしての SSIS パッケージの実行に関するページを参照してください) と [リソース ID] テキスト ボックスがあります。ここで Azure-SSIS IR リソース ID (/subscriptions/YourAzureSubscription/resourcegroups/YourResourceGroup/providers/Microsoft.DataFactory/factories/YourADF/integrationruntimes/YourAzureSSISIR) をコピーできます。 ADF と Azure-SSIS IR の名前を含む Azure-SSIS IR リソース ID のサフィックスによってクラスター ID が形成されます。これを使用して、独立系ソフトウェア ベンダー (ISV) から Premium またはライセンス SSIS コンポーネントを追加で購入し、それらを Azure-SSIS IR にバインドすることができます ( Azure-SSIS IR への Premium またはライセンス コンポーネントのインストールに関するページを参照してください)。

[SSISDB SERVER ENDPOINT](SSISDB サーバー エンドポイント) タイル

Azure SQL Database サーバーまたはマネージド インスタンスによってホストされている SSISDB にパッケージが格納されたプロジェクト配置モデルを使用している場合は、Azure-SSIS IR 監視ページに [SSISDB SERVER ENDPOINT](SSISDB サーバー エンドポイント) タイルが表示されます (Azure-SSIS IR デプロイ設定の構成に関するページを参照してください)。 このタイルでは、Azure SQL Database サーバーまたはマネージド インスタンスを示すリンクを選択してウィンドウをポップアップ表示し、そのウィンドウでテキスト ボックスからサーバー エンドポイントをコピーし、SSMS から接続してパッケージのデプロイ、構成、実行、管理を行うときに使用できます。 そのポップアップ ウィンドウで、 [See your Azure SQL Database or managed instance settings](Azure SQL Database またはマネージド インスタンスの設定を表示) リンクを選択して、Azure portal で SSISDB の再構成やサイズ変更を行うこともできます。

[PROXY / STAGING](プロキシ/ステージング) タイル

セルフホステッド IR (SHIR) をダウンロードしてインストールし、Azure-SSIS IR のプロキシとして構成してオンプレミスのデータにアクセスすると、Azure-SSIS IR の監視ページに [PROXY / STAGING](プロキシ/ステージング) タイルが表示されます (Azure-SSIS IR のプロキシとしての SHIR の構成に関するページを参照してください)。 このタイルでは、SHIR を指定するリンクを選択して、監視ページを開くことができます。 また、ステージング用の Azure Blob Storage を指定する別のリンクを選択して、リンクされたサービスを再構成することもできます。

[VALIDATE VNET / SUBNET](VNET/サブネットの検証) タイル

Azure-SSIS IR を VNet に参加させると、Azure-SSIS IR 監視ページに [VALIDATE VNET / SUBNET](VNET/サブネットの検証) タイルが表示されます (「Azure-SSIS Integration Runtime を仮想ネットワークに参加させる」を参照してください)。 このタイルでは、VNet とサブネットを指定するリンクを選択してウィンドウをポップアップ表示し、VNet リソース ID (/subscriptions/YourAzureSubscription/resourceGroups/YourResourceGroup/providers/Microsoft.Network/virtualNetworks/YourARMVNet) とサブネット名をテキスト ボックスからコピーしたり、VNet とサブネットの構成を検証して、Azure-SSIS IR の必要な受信/送信ネットワーク トラフィックと管理が妨げられないようにすることができます。

[接続の診断] タイル

Azure-SSIS IR 監視ページの [接続の診断] タイルで [テスト接続] リンクを選択してウィンドウをポップアップ表示し、そのウィンドウで、完全修飾ドメイン名 (FQDN) または IP アドレスと指定されたポートを使用して、Azure-SSIS IR と関連するパッケージ、構成、またはデータ ストアとの間の接続を確認できます (Azure-SSIS IR からの接続のテストに関するページを参照してください)。

[STATIC PUBLIC IP ADDRESSES](静的パブリック IP アドレス) タイル

Azure-SSIS IR にご自分の静的パブリック IP アドレスを使用すると、Azure-SSIS IR の監視ページに [STATIC PUBLIC IP ADDRESSES](静的パブリック IP アドレス) タイルが表示されます ( Azure-SSIS IR に自分の静的パブリック IP アドレスを使用する方法に関するページを参照してください)。 このタイルでは、Azure-SSIS IR の 1 つ目または 2 つ目の静的パブリック IP アドレスを指定するリンクを選択し、ウィンドウをポップアップ表示することができます。ここで、テキスト ボックスからリソース ID (/subscriptions/YourAzureSubscription/resourceGroups/YourResourceGroup/providers/Microsoft.Network/publicIPAddresses/YourPublicIPAddress) をコピーすることができます。 また、ポップアップ ウィンドウで [See your first/second static public IP address settings](1 つ目または 2 つ目の静的パブリック IP アドレス設定を表示する) リンクを選択し、Azure portal で 1 つ目または 2 つ目の静的パブリック IP アドレスを管理することもできます。

[PACKAGE STORES](パッケージ ストア) タイル

Azure SQL Managed Instance によってホストされ、Azure-SSIS IR パッケージ ストアを介して管理されるファイル システム、Azure Files、または SQL Server データベース (MSDB) にパッケージが格納されたパッケージ配置モデルを使用している場合は、Azure-SSIS IR 監視ページに パッケージ ストア タイルが表示されます (Azure-SSIS IR デプロイ設定の構成に関するページを参照してください)。 このタイルでは、Azure-SSIS IR に接続されているパッケージ ストアの数を示すリンクを選択してウィンドウをポップアップ表示し、そのウィンドウで、Azure SQL Managed Instance によってホストされているファイル システム、Azure Files、または MSDB 上の Azure-SSIS IR パッケージ ストアに関連するリンクされたサービスを再構成できます。

[エラー] タイル

Azure-SSIS IR の開始、停止、メンテナンス、アップグレードに問題がある場合は、Azure-SSIS IR 監視ページに [エラー] タイルが追加で表示されます。 このタイルでは、Azure-SSIS IR によって生成されるエラーの数を示すリンクを選択してウィンドウをポップアップ表示し、それらのエラーの詳細を確認してコピーし、トラブルシューティング ガイドで推奨されているソリューションを見つけることができます (Azure-SSIS IR のトラブルシューティングに関するページを参照してください)。

Azure Monitor を使用して Azure-SSIS Integration Runtime を監視する

Azure Monitor で Azure-SSIS IR を監視する方法については、「Azure Monitor による SSIS 操作の監視」を参照してください。

Azure-SSIS 統合ランタイムの詳細情報

Azure-SSIS 統合ランタイムについて詳しくは、以下の記事をご覧ください。

• Azure-SSIS 統合ランタイム: この記事では、Azure-SSIS IR など、統合ランタイムの一般的な概念について説明されています。
• チュートリアル: SSIS パッケージを Azure にデプロイする: この記事は、Azure-SSIS IR を作成し、Azure SQL Database を使用して SSIS カタログ (SSISDB) をホストするための詳細な手順を示しています。
• 方法: Azure-SSIS 統合ランタイムを作成する。 この記事では、このチュートリアルを発展させて、Azure SQL Managed Instance を使用して SSISDB をホストする手順について説明されています。
• Azure-SSIS IR を管理する: この記事では、Azure-SSIS IR を開始、停止、または削除する方法について説明されています。 また、ノードを追加してスケールアウトする方法についても説明されています。
• 仮想ネットワークへの Azure-SSIS IR の参加: この記事では、仮想ネットワークに Azure-SSIS IR を参加させる手順について説明されています。

関連するコンテンツ

パイプラインを監視するさまざまな方法について、次の記事をご覧ください。

• クイック スタート: データ ファクトリを作成する。
• Azure Monitor を使ってデータ ファクトリのパイプラインを監視する