Amazon パターンを使用した DynamoDB ディスカバリー

ServiceNow ディスカバリー と サービスマッピング の各アプリケーションでは、Amazon AWS DynamoDB パターンを使用して DynamoDB のコンポーネントを検索します。 これらのリソースを検出するには、ServiceNow Storeから最新バージョンの ディスカバリーとサービスマッピングパターン アプリケーションに更新する必要がある場合があります。

Amazon AWS DynamoDB パターンでは、DynamoDB に関する情報をフェッチするための REST API をデプロイします。また、AWSイベントを使用して AWS DynamoDB コンポーネントを検出するように サービスマッピング と ディスカバリー を設定することもできます。

ServiceNow AI Platform は、ディスカバリーおよびクラウドガバナンス向けに Amazon Commercial Cloud Services (C2S) をサポートしています。C2S は、AWS をインテリジェンスコミュニティに取り込む政府プログラムです。

ストアでアプリを要求する

ServiceNow Storeにアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認してください。リリースされたすべてのアプリのリリースメモ情報については、「ServiceNow Store バージョンの履歴リリースノート」を参照してください。

必須条件

ユーザーアクセス

AWS コンソールで、ユーザーに AmazonDynamoDBReadOnly アクセス権と AWSLambdaInvocation-DynamoDB の権限を付与します。

クラウドサービスアカウント

ServiceNow AI Platform® で、次のプロパティを使用してサービスアカウントを設定します。

• アカウント ID。DynamoDB が属する Amazon アカウント ID です。AWS マネジメントコンソールに表示されるアカウント ID を使用します。
• AWS クラウドに到達するためにアカウント ID で必要とされる適切な AWS 認証情報。

AWS認証情報

ServiceNow AI Platform® で、シークレットキーとアクセスキーを使用して AWS 認証情報を設定します。

DynamoDB を含むサービスのエントリーポイント

DynamoDB を含むサービスを作成するときは、エントリーポイントタイプとして [AWS リソース名エンドポイント] を使用します。Amazon リソース名 (ARN) とエントリーポイントのホストを指定します。

(サービスマッピング によるトップダウンディスカバリーの場合) 論理データセンターの水平ディスカバリーの実行

ServiceNow クラウドプロビジョニングとガバナンス のドキュメントの「AWS クラウドサービスアカウントでのディスカバリーの実行」の説明に従って、DynamoDB をホストする論理データセンターを検出します。

クラウドディスカバリー

クラウドディスカバリー の場合は、ServiceNow Store からディスカバリーとサービスマッピングパターンをダウンロードします。

MID サーバー

MID サーバーをインストールするときに、ホストマシンが「MID サーバーのシステム要件」を満たしているか超過していることを確認します。

ディスカバリースケジュール

ServiceNow クラウドプロビジョニングとガバナンス のドキュメントの「サービスアカウントでのディスカバリーのスケジュール設定 (Schedule Discovery on a service account)」の説明に従って、適切な AWS サービスアカウントのスケジュールを作成します。

AWS イベントサービスの構成

アラートベースのディスカバリーを有効にするには、ServiceNow クラウドプロビジョニングとガバナンス のドキュメントの「ディスカバリーおよびサービスマッピングの AWS イベント処理の設定 ( Set up AWS event processing for ディスカバリー and サービスマッピング)」の説明に従って、AWS イベントサービスを設定します。

REST API 権限を確認する

をダウンロードする クラウドディスカバリー パターンスプレッドシート そのため、 ディスカバリー パターンの実行に必要なユーザー権限を付与できます。権限に加えて、スプレッドシートには、パターン名、タイプ、CI クラス、ベンダードキュメントへのリンクなどの有用な情報も含まれています。新しいパターンは四半期ごとに提供されるため、定期的にチェックして、スプレッドシートが最新バージョンであることを確認してください。

注:

Postman API プラットフォーム を使用してAWS REST API をテストできます。詳細については、Now Support ナレッジベースの記事「How to test AWS REST API using POSTMAN [KB0782183] (POSTMAN [] を使用してテストする方法)を参照してください。

水平ディスカバリー中に ディスカバリー によって収集されるデータ

テーブルとフィールド	説明
DynamoDB グローバルテーブル [cmdb_ci_dynamodb_global_table]
オブジェクト ID [object_id]	Amazon リソースネーム (ARN) は、次の形式で表されます：arn:aws:dynamodb::xxxxxxxxxxxx:table:<table name>
DynamoDB テーブル [cmdb_ci_dynamodb_table]
名前 [name]	テーブル名
作成日 [creation date]	この DynamoDB を検出する MID サーバー のタイムゾーンに従った、DynamoDB の作成日。
クラウドプロバイダー [cloud_provider]	Amazon AWS
オブジェクト ID [object_id]	Amazon リソースネーム (ARN) は、次の形式で表されます：arn:aws:dynamodb:<region>:xxxxxxxxxxxx:table:<table name>
グローバル ARN [global_arn]	グローバル DynamoDB テーブルのグローバルテーブル ARN。DynamoDB がグローバルでない場合、このフィールドは空です。
ストリーム ARN [stream_arn]	以下から選択可能です。 ストリーム ARN 無効
サービス名 [service_name]	デフォルトでは DynamoDB に設定されています。
暗号化 [encryption]	DynamoDB での暗号化設定。以下から選択可能です。 有効 無効
レプリケーショングループ [replication_group]	接続されたグローバル DynamoDB テーブルのテーブル ARN。
読み込み自動スケーリング [read_autoscaling]	以下から選択可能です。 有効 無効
読み込み単位 [read_units]	DynamoDB テーブルの読み込み単位数。
読み込み最大単位 [read_max_units]	DynamoDB テーブルの許容最大読み込み単位数。
読み込み最小単位 [read_min_units]	DynamoDB テーブルの許容最小読み込み単位数。
書き込み単位 [write_units]	DynamoDB テーブルの書き込み単位数。
書き込み最大単位 [write_max_units]	DynamoDB テーブルの許容最大書き込み単位数。
書き込み最小単位 [write_min_units]	DynamoDB テーブルの許容最小書き込み単位数。
テーブルサイズ [table_size]	DynamoDB テーブルの現在プロビジョニングされているサイズ (バイト)。
書き込み自動スケーリング [write_autoscaling]	以下から選択可能です。 有効 無効
ポイントインタイム [point_in_time]	以下から選択可能です。 有効 無効

次の図は、DynamoDB ディスカバリーに含まれている CI を示しています。

図 : 1. DynamoDB コンポーネントを表示する依存関係ビュー

CI 関係

Amazon AWS DynamoDB パターンでは、次の CI 関係を作成します。

CI	関係	CI
DynamoDB グローバルテーブル [cmdb_ci_dynamodb_global_table]	Cluster of::Cluster	DynamoDB テーブル [cmdb_ci_dynamodb_table]

トップダウンディスカバリー中に サービスマッピング によって収集されるデータ

Amazon AWS DynamoDB パターンでは、DynamoDB から AWS Lambda 関数への接続を識別します。

トラブルシューティング

マッピングプロセスが期待どおりに進行しない場合は、次の提案に従ってください。

症状	原因	ソリューション
ディスカバリーに失敗しました。ディスカバリーメッセージには、REST タイムアウトによって発生したエラーに関する情報が含まれています。	展開で REST コール応答を送信する CI が多数あります。MID サーバー は mid.sa.cloud.request_timeout パラメーターで制御される制限時間を超えずに REST コール応答を処理することはできません。	デフォルトで、mid.sa.cloud.request_timeout パラメーターは 3 万ミリ秒に設定されています。 関連する MID サーバー に対してこのパラメーターの値を増やし、ディスカバリーを再実行します。 注: 関連する MID サーバー の [設定パラメーター] 関連リストにこのパラメーターが表示されない場合は、追加する必要があります。
デバッグセッション中にパターンデザイナーでエラーが発生しました。パターンデザイナーのメッセージに、タイムアウトによって発生したエラーに関する情報が含まれています。	パターンデザイナーは、(ディスカバリー時ではなく) パターンデバッグ中のタイムアウトが原因で失敗します。	デフォルトで、sa.debugger.max_timeout パラメーターは 240 秒に設定されています。 関連する MID サーバー に対してこのパラメーターの値を増やします。

関連タスク

• クラウドコンピューティングデバイスのクラウド REST クエリを定義します