建立報告報告

在符合先決條件之後，您就可以設定您的報告，AWS 帳戶並將使用資料傳送至AWS應用程式成本分析工具。本節說明如何設定報告，以及如何將使用情況資料傳送至「應用程式成本效能分析工具」。

設定 Application Cost Profiler 報告 Profiler 報告

下列程序顯示如何設定您要根據使用日期產生的報告。您可以配置詳細資料，例如產生報告的頻率。

注意

如果您AWS 帳戶是AWS組織的一部分，則可以使用管理帳戶或個別成員帳戶來設定報告。針對個別帳戶設定的報告僅包含該帳戶的資料。使用管理帳戶設定的報告可以包含整個組織的資料。

用於報告輸出的 Amazon S3 儲存貯體必須屬於建立報告組態的帳戶。

設定您的應用程式成本效能分析工具報表

1. 開啟 Web 瀏覽器，然後登入「應用程式成本效能分析工具」主控台。

2. 選擇立即開始設定或修改報告。

3. 輸入報表的「報表名稱」與「報表摘要」。

4. 在輸入 S3 儲存貯體名稱欄位中輸入 S3 儲存貯體的名稱，然後在輸入 S3 前置詞欄位中輸入 S3 前綴。如需建立 S3 儲存貯體和授與應用程式成本效能分析工具權限的詳細資訊，請參閱設定 Amazon S3 儲存貯體以適用於應用程式成本檔案器。

5. 選取您希望報告具有的選項：

   • 時間頻率 — 選擇報告是以「每日」或「每月」節奏產生，還是按兩者產生。

   • 報告輸出格式 — 選擇要在 Amazon S3 儲存貯體中建立的檔案類型。如果您選擇「CSV」，「應用程式成本效能分析工具」會為報表建立以 gzip 壓縮的逗號分隔值文字檔。如果您選擇「實木地板」，則會為報告產生「實木地板」檔案。

6. 選擇 [設定] 以儲存您的報告組態。

注意

您也可以使用AWS應用程式成本效能分析工具 API 來設定報表。

選擇立即開始檢視目前的報告組態，以驗證報告設定。

注意

您只能設定單一報告。返回配置頁面將編輯您現有的報告。

設定報表之後，即會啟用資料擷取。您可以將服務與應用程式成本分析工具整合，以提供資源的使用情況資料。

從您的服務報告租戶使用情況資料

設定報告之後，您就可以從帳戶中的資源或服務傳送租用戶使用情況資料。當您的資源用於特定承租人時，您必須通知應用程式成本分析工具。例如，如果您的服務接受來自不同承租人的 API 呼叫，您會在開始和結束該租用戶的 API 呼叫時，記錄每個租用戶的開始和結束時間。應用程式成本分析工具會使用該資料來產生有關服務成本的報告，依照每個租用戶的工作所花費的時間。

若要提供 Application Cost Profiler er 的使用量資料，請執行下列操作：

• 準備資源使用情況資料 — 建立表格，以說明何時將資源用於特定承租人。

• 上傳使用情況資料 — 將表上傳到您已授予應用程式成本分析工具存取權限的 Amazon S3 儲存貯體。

• 匯入使用情況資料 — 呼叫ImportApplicationUsage API 作業，讓應用程式成本效能分析工具知道資料已準備好可供處理。

以下章節將更詳細地說明這些步驟的詳細說明這些步驟。

步驟 1：準備資源使用情況資料

當您的服務中使用資源時，您可以追蹤哪個租用戶正在使用該資源。將此資料記錄到表格中，您可以稍後上傳以供「應用程式成本效能分析工具」匯入。表格中的每個資料列都說明資源、使用該資源的承租人，以及該使用狀況的開始和結束時間。資源的範例是 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體正在使用的一個資源範例。

此步驟要求您將程式碼整合到服務中，才能輸出有關使用情況的正確資訊。

下表列出了資源使用率表中的欄位，列在下表中。

欄位	描述
ApplicationId	識別系統中正在使用的應用程式或產品。定義承租人中繼資料的範圍。
TenantId	您系統中使用指定資源之承租人的識別碼。「應用程式成本效能分析工具」會在中彙總至此層級ApplicationId。
TenantDesc	(選擇性) 有關租用戶的其他資料，以供您自己的其他報告使用。
UsageAccountId	資源執行所在的帳號 (對組織中的帳號很重要)。
StartTime	來自 Epoch 的時間戳記（以毫秒和微秒為單位），以 UTC 為單位。指出指定承租人之使用期間的開始時間。
EndTime	來自 Epoch 的時間戳記（以毫秒和微秒為單位），以 UTC 為單位。指出指定承租人之使用期間的結束時間。
ResourceId	正在使用的 Amazon Resource Name (ARN)。
名稱	(選擇性) 作為指定的替代方法 ResourceId，您可以指定一組資源的屬性成本的名稱資源標籤 (欄位必須包含您要用於「名稱」標籤的值)。資源標籤會啟用，作為成本和用量報告的一部分開啟。如需有關資源標籤的詳細資訊，請參閱成本與使用量報告使用者指南中的資源標籤詳細資料。

輸出資料必須位於逗號分隔值 (.csv) 檔案中，如下列範例所示。

ApplicationId,TenantId,TenantDesc,UsageAccountId,StartTime,EndTime,ResourceId
MyApp,Tenant1,,123456789012,1613681437032.9001,1613681437041.5312,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681245531.4426,1613681245551.1323,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant1,,123456789012,1613681904815.3381,1613681904930.0972,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681904765.1956,1613681904946.574,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234

將資料儲存為檔案，副檔名為 .csv (如果使用 gzip 壓縮，則為 .csv.gzip)。當您將此資料上傳至應用程式成本效能分析工具時，每次都會指派給相關承租人。在此範例中，報告包含該租用戶的 Amazon EC2 執行個體成本的時段。僅適用於 Amazon EC2 執行個體，與特定租用戶無關聯的磁碟片段會新增至未歸屬的租用戶。重疊的時間片段會計算多次。您有責任確保使用情況表中的資料準確無誤。

注意

您的檔案必須表示一小時的時間。如果資源使用了多個小時，請在小時結束使用量，並在下一個檔案中同時啟動新記錄。

您必須提交包含整個小時資料的單一檔案。如果針對同一小時的資料提交多個檔案，「應用程式成本分析工具」只會考慮最新檔案中的資料。

例如，下表顯示「應用程式成本效能分析工具」如何根據提供的時間片段，計算一小時內 (3,600,000 毫秒) 三個租用戶的使用量。

租客	提供的時間片段	計算每小時成本的百分比
租戶 1	二十萬毫秒	33.34%
租戶 2	60 萬毫秒	16.66%
<unattributed>		50.00%

在此範例中，承租人 1 被指派為小時的三分之一，而承租人 2 被指派為小時的六分之一。剩餘的半小時（1,800,000 毫秒）不歸因於任何一個客戶，這是小時的 50％。

目前，已針對「應用程式成本效能分析工具」啟用下列資源：

• Amazon EC2 執行個體 (僅限隨需和競價型執行個體)

• Lambda 函數 (如果您要傳送 Lambda 函數的資料，則必須將不合格的資源 ARN 傳送為ResourceId。)

• Amazon EElastic Container Service (Amazon ECS) 執行個體

• Amazon Simple Queue Service (Amazon SQS) 佇列

• Amazon Simple Notification Service (Amazon SNS) 主題

• Amazon DynamoDB 讀寫

注意

Amazon SQS、Amazon SNS 和 DynamoDB 的用量不會按時間收費，這與大多數資源不同。在這種情況下，一小時內的使用量 (例如，DynamoDB 中的一些讀取和寫入) 會依您配置給不同租用戶的小時百分比分類，而不論讀取或寫入何時在該小時內發生。

步驟 2：上傳資源使用量

取得租用戶的使用檔案後，請將您的資料檔案上傳到 Amazon S3，並確定應用程式成本分析工具具有存取該檔案的權限。

如需進一步了解如何建立 S3 儲存貯體，請參閱應用程式成本效能分析工具特定的。

您必須確定應用程式成本效能分析工具可存取 S3 儲存貯體。每個 S3 儲存貯體只需要執行一次 (您可以重複使用同一個儲存貯體來上傳多個使用情況檔案)。如需有關授予值區存取權的資訊，請參閱授予應用程序成本分析器訪問您的使用數據 S3 存儲桶。如果儲存貯體已加密，請參閱為應用程序成本分析器提供對 SSE-KMS 加密 S3 存儲桶的訪問權限。

注意

您不需要加密用於使用情況資料的 S3 儲存貯體。

將您的資料以檔案形式上傳到 S3 儲存貯體，副檔名為 .csv (如果使用 gzip 壓縮，則為 .csv.gzip)，每小時一次。上傳新檔案之後，您必須通知「應用程式成本效能分析工具」您已上傳檔案，以便將檔案匯入報表中。

注意

讓「應用程式成本分析工具」存取您的使用資料，即表示您同意我們可以在處理報告時，暫時將此類使用情況資料物件複製到美國東部 (維吉尼亞北部)AWS 區域。這些資料物件將一直保留在 US East (Virginia) 區域，直到報告產出完成為止。

步驟 3：將使用情況資料匯入應用程式成本分析工具

將使用情況資料上傳到應用程式成本分析工具可存取的 Amazon S3 儲存貯體之後，請通知應用程式成本分析工具該資料存在，並將其匯入最終報告。您可以使用應用程式成本效能分析工具 API 中的ImportApplicationUsage作業來執行此操作。

如需AWS應用程式成本效能分析工具 API (包括ImportApplicationUsage作業) 的相關資訊，請參閱AWS應用程式成本效能分析工具 API 參考資料。

下列範例顯示如何呼叫ImportApplicationUsage。將括號中的輸入文字取代為 S3 儲存貯體和上傳物件的值。

POST /ImportApplicationUsage HTTP/1.1
Content-type: application/json

{
    "sourceS3Location" : {
        "bucket": "<bucket-name>",
        "key": "<object-key>",
        "region": "<region-id>"
    }
}

注意

只有當儲存貯體位於預設為停用狀態時，才需要AWS 區域使用此region參數。如需詳細資訊，請參閱AWS 區域中的管理AWS 一般參考。

「應用程式成本效能分析工具」會使用您匯入的資料，依據您在設定報表時要求的頻率，產生新的報表ImportApplicationUsage。

在您設定報表並將使用情況資料自動匯入「應用程式成本分析工具」之後，您就可以檢視產生的報表。如需報告的詳細資訊，請參閱使用 Application Storage Profiler 報告。