Azure Automation にて特定期間のジョブの実行時間を取得する

Published: / Last update:
Contributors:
feedback 共有

こんにちは Azure サポート チームの村田です。
Azure Automation においては昨年価格体系が変更されました

具体的には以下のように以前の Free、Basic という概念がなくなり、以下のように統合された価格体系となっております。

  • 以前の価格料金
    • Free - 月あたり 500 分の無料時間が付与され、超過した場合はジョブが実行されなくなります。
    • Basic - 従量課金として、$0.002 / 分 で課金が発生します。
  • 変更後の価格体系
    • 無償の500分のジョブ実行時間が付与され、超過した分に関しましては、$0.002 / 分 で課金が発生します（実際の価格は、購入日によって異なる場合があります）。

参照情報

以前は Basic プランの場合、最初の1分から課金対象となっていましたが、新しいプランでは、必ず 月あたり 500 分の無料ジョブ実行時間がつくのでプラン的にはお得になってますね。

しかし、この価格体系の変更に伴い、Automation アカウントの画面内から、月のジョブの実行時間の累計を表示する項目が消えてしまいました。

したがいまして、今どの程度ジョブの実行時間を消費しているのかわからないとご質問をいただく場合がございます。

そんな場合に備え、今回はローカルから PowerShell を実行する事で、特定の期間のジョブの実行時間を取得するスクリプトをご案内します。

日別にジョブ実行時間が取得できるため、特定の日時のみジョブの実行時間がとても長い際などには、トラブルシューティングにも便利ですので是非ご利用ください。

スクリプトの実行環境要件

Windows 11またはWindows Server 2022/2025でコンピュータを実行している場合は、すでにPowerShell 5以降がインストールされているため、実行環境の準備は必要ありません。

Az PowerShell モジュールのインストール

AzureからPowerShell経由で情報を照会できるようにするには、Az PowerShell モジュールをインストールする必要があります。

先に進む前に、お使いのコンピュータがパッケージ管理の要件を満たしていることを確認してください。

Az PowerShell モジュールをインストールするには、以下の手順に従います。

  1. [管理者として実行]オプションを使用してPowerShellセッションを開きます。
  2. Install-Module -Name Az -Repository PSGallery -Forceと入力し、Enterキーを押します。
  3. インストールが完了するまで待ち、PowerShellのプロンプトに戻ります。
  4. モジュールがインストールされたことを確認するために、Get-Module -Name Az* -ListAvailableと入力し、Enterキーを押します。

実行スクリプト

PowerShell ISE を起動し、以下のスクリプトを貼り付け、期間を指定して実行します。
※ブロックが複数にわかれておりますが、すべて一つのスクリプトに記載してください。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
Connect-AzAccount
#ジョブの実行時間を保存するディレクトリを記載します。
$CSVFile = "c:\temp\automation.csv"
#ジョブの実行時間を取得する期間の開始日時を指定します
$StartTime = "12/01/2017"
#ジョブの実行時間を取得する期間の終了日時を指定します
$EndTime = "12/08/2017"

#ジョブの実行時間を取得するサブスクリプションID を記載します
$SubscriptionID = 'Subscription ID'
Set-AzContext -SubscriptionId $SubscriptionID

$UsageInfo = Get-AzUsageAggregate -ReportedStartTime $StartTime -ReportedEndTime $EndTime -AggregationGranularity Daily -ShowDetails $true

 Do { 
    $UsageInfo.UsageAggregations.Properties | Where-Object {($_.MeterCategory -eq 'Automation') -and ($_.MeterName -eq 'Basic Runtime')} | `
            Select-Object `
            UsageStartTime, `
            UsageEndTime, `
            @{n='SubscriptionId';e={$SubscriptionId}}, `
            MeterCategory, `
            MeterId, `
            MeterName, `
            MeterSubCategory, `
            MeterRegion, `
            Unit, `
            Quantity, `
            @{n='Project';e={$_.InfoFields.Project}}, `
            InstanceData `
            | Export-Csv -Append:$true -NoTypeInformation:$true -Path $CSVFile
    if ($UsageInfo.NextLink) 
    {
        $ContinuationToken = [System.Web.HttpUtility]::UrlDecode($UsageInfo.NextLink.Split("=")[-1])
        $UsageInfo = Get-UsageAggregates -ReportedStartTime $StartTime -ReportedEndTime $EndTime `
                            -AggregationGranularity Daily -ShowDetails $true -ContinuationToken $ContinuationToken
    }
    else
    {
       $ContinuationToken = "" 
   }
 } Until (!$ContinuationToken)

なお実行時に下図のエラーが発生する場合は System.Web アセンブリがよみこまれていない可能性が高いため、以下のコマンドをローカルの環境にてご実施いただければと存じます。

エラー画面

実行していただきたいコマンド

1
PS C:\> Add-Type -AssemblyName System.Web

結果として下図のように日時別のジョブの実行時間が CSV で取得できます。

”Quantity” 欄にて分単位でジョブの実行時間が表示されるのが確認できます。
この結果では 11 月で約67分のジョブ実行時間なので無償の範囲内ですね。
月別に出力して、管理することで、変遷を確認するなど運用にお役に立てていただければ幸いです。

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。