こちらの記事は、CUDOS構築記 Vol.3: CURの出力と集約先へのレプリケーション設定をするの続きです。
前回は、CURの集約先の作成について紹介しました。今回は、Step3:データソース、およびダッシュボードの作成についてコードを交えながら解説します。
本記事の構成
- 前提のおさらい
- 構築範囲の確認
- 構築手順
前提のおさらい
- CUDSの構築ステップは3つ
- （作成済み）Step1: CURの集約先を作成する
- （作成済み）Step2: CURの出力と集約先へのレプリケーション設定をする
- Step3: データソース、およびダッシュボードを作成する
- 構築先アカウント
- Step1,3:ダッシュボードを設置するアカウント
- Step2: 可視化対象アカウントすべて
- CUDOSの構築方針
- Step1,2はTerraformで構築
- Step3はCLI（cid-cmd tool）で構築
構築範囲の確認
赤枠で囲ってある範囲が、本記事で構築する対象です。
データソースの設定とダッシュボードを作成します。
ここまでの構築が終わっていれば、コマンドを叩くだけでダッシュボードが作成されます。
構築作業
前提
- Step2の構築が完了していること
- 設定先のAWSアカウントに対する適切なアクセス権限を保持していること
-
Athenaのworkgroupが設定済みであること- 未設定の場合は、サンプルコードを参考に設定してください
-
QuickSightのEnterprise editionが利用可能であること- QuickSightを利用したことがない場合は、公式ドキュメント 3.1-prepare-amazon-quicksightを参考に設定してください
Athenaのworkgroupの設定サンプル
Athenaのworkgroupの設定サンプル
resource "aws_athena_workgroup" "cid" {
name = "CID"
description = "Used for CloudIntelligenceDashboards"
configuration {
enforce_workgroup_configuration = true
publish_cloudwatch_metrics_enabled = true
result_configuration {
output_location = "s3://<your-bucket-name-of-athena-result>/"
encryption_configuration {
encryption_option = "SSE_S3"
}
}
}
}
事前準備
ダッシュボードを設置するAWSアカウントにログインして、CloudShellを起動します。
この際に、リージョンがus-east-1であることを確認してください。
CILのインストール
コマンドラインツールであるcid-cmdをインストールします。
python3 -m ensurepip --upgrade
...
pip3 install --upgrade cid-cmd
...
デプロイ
cid-cmd deploy
インタラクティブなプロンプトが表示されるので、入力していきます。
# デプロイするダッシュボード: CUDOS Dashboard v5
? [dashboard-id] Please select a dashboard to deploy: (Use arrow keys)
FOUNDATIONAL
» [cudos-v5] CUDOS Dashboard v5
# Athenaのworkgroup: 事前に作成したものを選択
? [athena-workgroup] Select Amazon Athena workgroup to use: (Use arrow keys)
» CID
primary
# データソース: 新規作成
? [quicksight-datasource-id] Please choose DataSource (Select the first one if not sure): (Use arrow keys)
» CID-CMD-Athena <CREATE NEW DATASOURCE>
# QuickSightのロール: 新規作成
? [quicksight-datasource-role] Please choose a QuickSight role. It must have access to Athena: (Use arrow keys)
<USE DEFAULT QuickSight ROLE (You will need to login to QuickSight (https://quicksight.aws.amazon.com/sn/admin#aws) and configure S3 and Athena access there)>
aws-quicksight-service-role-v0
» CidCmdQuickSightDataSourceRole <ADD NEW ROLE>
# Athenaのデータベース: 新規作成
? [athena-database] Select AWS Athena database to use: (Use arrow keys)
» customer_cur_data (CREATE NEW)
# Step1で作成したCURの集約先のバケットを選択
? [view-cur-s3-bucket] Enter a bucket with CUR: (Use arrow keys)
» cid-xxxxxxx-shared
# CURのパス
? [view-cur-location] Enter an S3 path. We support only 2 types of CUR path: s3://{bucket}/cur and s3://{bucket}/{prefix}/{name}/{name}: s3://cid-xxxxxxx-shared/cur/
# GlueCrawlerのロール: 新規作成
? [crawler-role] Provide a crawler role name: (Use arrow keys)
» CidCmdCurCrawlerRole <CREATE NEW>
# ダッシュボード上のアカウント表示名の設定
# こちらは後から変更するので、Dummyを選択
? [account-map-source] Please select account metadata collection method: (Use arrow keys)
» Dummy (CUR account data, no names)
AWS Organizations (one time account listing)
CSV file (relative path required)
# Timezoneの設定
? [timezone] Please select timezone for datasets scheduled refresh.: Asia/Tokyo
# ダッシュボードの共有設定: こちらはお好みで
[share-with-account] Share this dashboard with everyone in the account?: (Use arrow keys)
» No
CUDOS Dashboard v5 is available at: <URL>
最後に出力されるたURLへアクセスして、ダッシュボードが表示されることを確認してください。
CURに関しては反映まで24時間ほどかかるので、時間をおいて確認してください。
以上で、この記事は終了です。
これまで4回にわたって、CUDOSの構築手順を解説してきました。
CUDOSを構築するに当たり、情報が少なく手探りで進めることが多かったので、今後の誰かの参考になればと思い執筆しました。
もし、何か不明点や誤りがあれば、お気軽にコメントいただけると幸いです。