本文へスキップ

適用方法

WhaTapは、データベースのログモニタリングを提供します。 サーバーインストール型データベースと、クラウドサービスであるAWS RDSのログを収集できます。 これにより、WhaTapのログモニタリング機能であるライブテール、ログトレンドメニューからデータベースの散在したログをひと目で確認することができます。

Tips

ログモニタリングを適用した後、各メニューのカテゴリ項目とログ一覧からインストール型DBは、 #DB、AWS RDSは#RDS_LOG、#RDS_EVENTと表示されます。

카테고리

サーバーインストール型DBに適用する​

サーバーインストール型データベースのログをモニタリングするには、WhaTapの_xos.conf_ファイルに次のオプションを適用してください。

ノート

適用する前に、XOSエージェントをインストールしてエージェント設定を行う必要があります。 詳細については、次の文書を参照してください。

AWS RDS Logに適用する​

AWS RDS Logモニタリングのための構成​

AWS RDS Log

AWSではRDSのモニタリング向けに様々な情報を提供しますが、これらの情報を確認するにはAWSコンソールから直接アクセスする必要があります。 しかし、WhaTapのAWS RDS LogはデータベースモニタリングのログメニューからRDSのログとイベントを集約して表示します。

WhaTapのAWS RDS LogはAWS CloudFormationを通じてインストールできます。 AWS CloudFormationについての詳細は次のリンクを参照してください。

権限確認​

AWS CloudFormationを通じてWhaTapのAWS RDS Logをインストールするには、まず必要なIAM権限を確認してください。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:CreateStack",
        "cloudformation:UpdateStack",
        "cloudformation:DeleteStack",
        "cloudformation:DescribeStacks",
        "cloudformation:DescribeStackEvents",
        "cloudformation:DescribeStackResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:CreateBucket",
        "s3:PutBucketVersioning",
        "s3:PutBucketPublicAccessBlock"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "lambda:CreateFunction",
        "lambda:UpdateFunctionCode",
        "lambda:UpdateFunctionConfiguration",
        "lambda:DeleteFunction",
        "lambda:AddPermission"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:CreateRole",
        "iam:GetRole",
        "iam:AttachRolePolicy"
      ],
      "Resource": "*"
    }
  ]
}

インストールと設定​

  1. WhaTapが提供するAWSCloudFormationテンプレートを通じてインストールすることができます。 次のリンクへ移動してから、パラメータセクションで以下の項目を入力してください。

    AWS CloudFormation Install

    • Host: WhaTap収集サーバーアドレス。WhaTapプロジェクトの管理>エージェントインストールメニューで確認できます。 例）13.124.11.223/13.209.172.35

    • MemorySize: WhaTapRDSLogのメモリサイズ。128MB ~ 10,240MB間の値を入力してください。

    • Pcode: WhaTapプロジェクトのプロジェクトコード。管理>プロジェクト管理*メニューでプロジェクトコード項目を確認してください。

    • ProjectAccessKey: WhaTapプロジェクトのアクセスキー。管理>プロジェクト管理メニューでプロジェクトアクセスキー項目を確認してください。

    • TimeOut: インストールされるWhaTapRDSLogが実行時に最大に維持できる時間です。

    • UseReservedConcurrency: WhaTap RDSの予約された同時性の使用有無です。

    • ReservedConcurrency: WhaTap RDSが予約された同時性を使用したときに、同時に実行できる最大インスタンスの数です。

  2. ログモニタリングの詳細設定のために、次のリンクへ移動してください。

    AWS CloudFormation Setting

  3. パラメータセクションで以下の項目を順番に入力してください。

    • AwsRdsNames: イベントを受信したいRDS Cluster、Instanceの名前一覧

      • 例）database-1、seoul-pro-db-01、seoul-pro-db-01-writer …

      • EventRuleを生成しないためには、noneを入力してください。

    • RdsLogGroupName(1~9): ログを受信したいRDS CloudWatchLogGroup Name

      • 例）/aws/rds/seoul-pro-db-01

      • サブスクリプションフィルターを生成しない場合は、 none を入力してください。

      ノート

      CloudWatchLogGroupは一度に最大9つまで接続できます。

    • WhaTapRDSLogArn: 前の段階で生成されたWhaTapRDSLogArn

      AWS CloudFormation output

生成リソースを確認する​

AWS CloudFormationからインストールされているリソースを確認してください。

AWS RDS Log

  • S3

    • Bucket:WhaTapAWS RDS Logの実行ファイルを保存するAWS S3 Bucket (CopyZips)

  • Lambda

    • Function

      • CopyZipsFunction:WhaTap AWS S3 Bucketからユーザーの環境に実行ファイルを移すAWS Lambda Function

      • WhaTapRDSLog: AWS RDSのモニタリングのためのAWS Lambda Function

    • Permission

      • CWPermission: RDS CloudWatchLogGroupにLogが生成される時、WhaTapRDSLogを実行できるようにするPermission

      • EventBridgePermission: RDS Eventが発生した場合、EventBridgeでWhaTapRDSLogを実行できるようにするPermission

    • Role

      • CopyZipsFuntionがWhaTapのS3からファイルをインポートし、CopyZipsに入れるために必要なRole

      • WhaTapRDSLogがCloudWatchLogGroupにLogを残すために必要なRole

フィルターとルールを確認する​

AWS CloudFormation

  • WS CloudWatchLogGroup

    SubscriptionFilter(1~9): RDSの CloudWatch LogGroupに Logが入ってくるとWhatapRDSLogを実行させるフィルター

  • AWS EventBridge

    Rule: AWSイベントで、RDSと関連したイベントが発生するとWhatapRDSLogを実行させるルール

ログモニタリングを開始する​

すべての設定を完了した後、ログ>ログ設定メニューにアクセスし、ログモニタリングを活性化してください。

ログモニタリングの開始