第14章 metrics-utility による使用状況レポート

手順

1. ユーザーのホームディレクトリーに 2 つのスクリプトを作成し、metrics-utility が 関連するすべてのデータを収集できるように、正しい変数を設定してください。

   1. /home/my-user/cron-gather 内:

      #!/bin/sh
      
      # Specify the following variables to indicate where the report is deposited in your file system:
      export METRICS_UTILITY_SHIP_TARGET=directory
      export METRICS_UTILITY_SHIP_PATH=/awx_devel/awx-dev/metrics-utility/shipped_data/billing
      
      # Run the following command to gather and store the data in the provided SHIP_PATH directory:
      metrics-utility gather_automation_controller_billing_data --ship --until=10m

   2. /home/my-user/cron-report 内:

      #!/bin/sh
      
      # Specify the following variables to indicate where the report is deposited in your file system:
      export METRICS_UTILITY_SHIP_TARGET=directory
      export METRICS_UTILITY_SHIP_PATH=/awx_devel/awx-dev/metrics-utility/shipped_data/billing
      
      # Set these variables to generate a report:
      export METRICS_UTILITY_REPORT_TYPE=CCSPv2
      export METRICS_UTILITY_PRICE_PER_NODE=11.55 # in USD
      export METRICS_UTILITY_REPORT_SKU=MCT3752MO
      export METRICS_UTILITY_REPORT_SKU_DESCRIPTION="EX: Red Hat Ansible Automation Platform, Full Support (1 Managed Node, Dedicated, Monthly)"
      @@ -44,21 +51,31 @@ export METRICS_UTILITY_REPORT_EMAIL="email@email.com"
      export METRICS_UTILITY_REPORT_RHN_LOGIN="test_login"
      export METRICS_UTILITY_REPORT_COMPANY_BUSINESS_LEADER="BUSINESS LEADER"
      export METRICS_UTILITY_REPORT_COMPANY_PROCUREMENT_LEADER="PROCUREMENT LEADER"
      
      # Build the report
      metrics-utility build_report

2. これらのファイルを実行可能にするために、次のコマンドを実行します。

   chmod a+x /home/my-user/cron-gather /home/my-user/cron-report

3. cron ファイルを編集用に開くには、以下を実行します。

   crontab -e

4. 実行スケジュールを設定するには、ファイルの末尾に次のパラメーターを追加し、cron 構文を 使用して metrics-utility が 情報を収集してレポートを作成する頻度を指定します。次の例では、gather コマンドは毎時 00 分に実行されるように設定されています。build_report コマンドは、毎月 2 日の午前 4 時に実行されるように設定されています。

   0 */1 * * * /home/my-user/cron-gather
   0 4 2 * * /home/my-user/cron-report

5. ファイルを保存してから閉じます。

6. 変更を保存したことを確認するには、以下を実行します。

   crontab -l

7. データが収集されていることを確認するために、次を実行します。

   cat /var/log/cron

   以下は出力の例です。日時は、実行スケジュールをどのように設定するかによって異なる可能性があることに注意してください。

   May  8 09:45:03 ip-10-0-6-23 CROND[51623]: (root) CMDOUT (No billing data for month: 2024-04)
   May  8 09:45:03 ip-10-0-6-23 CROND[51623]: (root) CMDEND (metrics-utility build_report)
   May  8 09:45:19 ip-10-0-6-23 crontab[51619]: (root) END EDIT (root)
   May  8 09:45:34 ip-10-0-6-23 crontab[51659]: (root) BEGIN EDIT (root)
   May  8 09:46:01 ip-10-0-6-23 CROND[51688]: (root) CMD (metrics-utility gather_automation_controller_billing_data --ship --until=10m)
   May  8 09:46:03 ip-10-0-6-23 CROND[51669]: (root) CMDOUT (/tmp/9e3f86ee-c92e-4b05-8217-72c496e6ffd9-2024-05-08-093402+0000-2024-05-08-093602+0000-0.tar.gz)
   May  8 09:46:03 ip-10-0-6-23 CROND[51669]: (root) CMDEND (metrics-utility gather_automation_controller_billing_data --ship --until=10m)
   May  8 09:46:26 ip-10-0-6-23 crontab[51659]: (root) END EDIT (root)

   生成されたレポートには、CCSP-<YEAR>-<MONTH>.xlsx というデフォルトの名前が付けられます。レポートはステップ 1a で指定した送信先パスに保存されます。