データベース・インスタンス・モニタリングの設定

1. ナビゲーション・メニューを開き、「オブザーバビリティおよび管理」をクリックします。「Log Analytics」で、「管理」をクリックします。

2. 管理リソースが、左側のナビゲーション・ペインにある「管理」の下にリストされます。「ソース」をクリックします。

3. 「ソース」ページで、「ソースの作成」をクリックします。

   「ソースの作成」ダイアログ・ボックスが表示されます。

4. 「ソース」フィールドに、ソースの名前を入力します。

5. 「ソース・タイプ」リストから、「データベース」を選択します。

6. 「エンティティ・タイプ」をクリックして、必要なエンティティ・タイプを選択します。たとえば、Oracle Databaseインスタンス、Oracleプラガブル・データベース、Microsoft SQL Serverデータベース・インスタンスまたはMySQLデータベース・インスタンス。

7. 「データベース問合せ」タブで、「追加」をクリックし、Oracle Log Analyticsインスタンスによってデータベース・インスタンス・ログが収集される基準となるSQL問合せの詳細を指定します。

   SQL問合せのガイドラインを参照してください。

8. 「構成」をクリックして、「列マッピングの構成」ダイアログ・ボックスを表示します。

9. 「列マッピングの構成」ダイアログ・ボックスで、SQLフィールドを、実際のログ・レコードに表示されるフィールド名にマップします。マッピング用の新しいフィールドを作成するには、アイコンをクリックします。

   順序列を指定します。このフィールドの値によって、表に挿入されるレコードの順序が決まります。これには一意の増分値が必要です。フィールドでレコードの順序を決定しない場合は、「SQL問合せ収集時間」を選択して、収集時間をログ・エントリ時間として使用できます。その場合、すべてのログ・レコードは収集サイクルごとに再収集されます。

   ノート
   
   

   データ型がTimestampの最初のマップ済フィールドは、ログ・レコードのタイムスタンプとして使用されます。そのようなフィールドが存在しない場合、ログ・レコードの時間として収集時間が使用されます。

   ログ・ソースの作成後に初めてログが収集される場合(履歴ログ収集):

   • SQL問合せのフィールドがTimeフィールドにマップされている場合、そのフィールドの値は、過去30日間のログ・レコードをアップロードするための参照として使用されます。

   • SQL問合せのどのフィールドもTimeフィールドにマップされていない場合、最大10,000,000レコードがアップロードされます。

   「完了」をクリックします。

10. 複数のSQL問合せを追加するには、ステップ6からステップ8までを繰り返します。

    既存のSQL問合せを再利用して別の問合せを作成するには、元の問合せに対応する行の「アクション」メニューをクリックし、「複製」をクリックします。元の問合せのコピーとマッピングを編集できるようになりました。ステップ8から9を繰り返して、問合せの変更、列の追加と削除、および列マッピングの変更を行います。

11. 各SQL問合せの「有効」を選択し、「保存」をクリックします。

データベース・ログ・ソースで定義されているデータの収集に使用されるエンティティごとに、そのエンティティに接続してSQL問合せを実行するために必要な資格証明をエージェントに提供します。これらの資格証明は、クラウド・エージェントによってローカルで管理されている資格証明ストアに登録する必要があります。資格証明は、エンティティからログ・データを収集するためにクラウド・エージェントによって使用されます。

1. 管理エージェントがインストールされているホストにログインします。

2. DBCredsタイプの資格証明JSON入力ファイルを作成します。たとえば、agent_dbcreds.json:

   cat agent_dbcreds.json
   {
       "source": "lacollector.la_database_sql",
       "name": "LCAgentDBCreds.<entity_name>",
         "type": "DBCreds",
       "usage": "LOGANALYTICS",
       "disabled": "false",
       "properties": [
           {
               "name": "DBUserName",
               "value": "CLEAR[username]"
           },
           {
               "name": "DBPassword",
               "value": "CLEAR[password]"
           },
           {
               "name": "DBRole",
               "value": "CLEAR[normal]"
           }
       ]
   }

   前述の例のagent_dbcreds.jsonのように、入力ファイルに次のプロパティを指定する必要があります:

   • source: "lacollector.la_database_sql"
   • name: "LCAgentDBCreds.<entity_name>"

     entity_nameは、エンティティの作成時に入力した「名前」フィールドの値です。

   • type: "DBCreds"
   • usage: "LOGANALYTICS"
   • properties: ユーザー名、パスワードおよびロール。ロールはオプションです。

3. upsertCredentials操作とともにcredential_mgmt.shスクリプトを使用して、エージェントの資格証明ストアに資格証明を追加します:

   構文:

   $cat <input_file> | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s <service_name>

   前述のコマンドで:

   • 入力ファイル: 資格証明パラメータを含む入力JSONファイル(agent_dbcreds.jsonなど)。
   • サービス名: loganをエージェントにデプロイされたOracle Log Analyticsプラグインの名前として使用します。

   2つのパラメータの例の値を使用すると、コマンドは次のようになります:

   $cat agent_dbcreds.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

   資格証明が正常に追加されたら、入力JSONファイルを削除できます。

   管理エージェント資格証明ストアでの資格証明の管理の詳細は、管理エージェント・ドキュメントの管理エージェントのソース資格証明を参照してください。

トピック

• 始める前に
• ソースとエンティティのアソシエーションへのアクセス
• アソシエーションの資格証明の変更
• OCI Vaultでの名前付き資格証明の作成

開始する前に

データベース・ソースで、ソース・タイプとして「データベース」が選択されていることを確認します。

データベース・エンティティが管理エージェントに関連付けられていることを確認します。アソシエーションの構成中にOCI Vaultで名前付き資格証明を作成すると、名前付き資格証明がエンティティのスコープにある管理エージェントに適用されます。

次のいずれかの資格証明ソースを使用できます。

管理エージェントで使用する名前付き資格証明を作成または登録します。管理エージェントのソース資格証明を参照してください。OCI Vaultの名前付き資格証明の場合は、事前に資格証明を識別するか、資格証明をアソシエーションに追加しながら作成します。OCI Vaultでの名前付き資格証明の作成を参照してください。

ソースとエンティティのアソシエーションへのアクセス

ソースの詳細ページからアソシエーションにアクセスするには:

1. ナビゲーション・メニューを開き、「オブザーバビリティおよび管理」をクリックします。「Log Analytics」で、「管理」をクリックします。

   管理リソースが、左側のナビゲーション・ペインにある「管理」の下にリストされます。「ソース」をクリックします。「ソース」リスト・ページが開きます。

2. データベース・ソースの名前をクリックします。ソースの詳細ページが開きます。

   「関連付けられたエンティティ」セクションに移動します。

3. 更新するエンティティ・アソシエーションに対して、「アクション」メニューをクリックし、「アソシエーションの編集」をクリックします。

エンティティの詳細ページからアソシエーションにアクセスするには:

1. ナビゲーション・メニューを開き、「オブザーバビリティおよび管理」をクリックします。「Log Analytics」で、「管理」をクリックします。

   管理リソースが、左側のナビゲーション・ペインにある「管理」の下にリストされます。「エンティティ」をクリックします。「エンティティ」リスト・ページが開きます。

2. エンティティの名前をクリックします。エンティティの詳細ページが開きます。

   関連付けられたソース・リストで、データベース・ソースを検索します。

3. 更新するソース・アソシエーションに対して、「アクション」メニューをクリックし、「アソシエーションの編集」をクリックします。

「アソシエーションの編集」ダイアログ・ボックスに「資格証明」セクションが表示されます。

アソシエーションの資格証明の変更

次のステップを使用して、データベースのソース・エンティティ・アソシエーションで使用される資格証明を変更します。

1. 「アソシエーションの編集」ダイアログ・ボックスで、「資格証明」セクションに移動します。

   アソシエーションに現在設定されている資格証明名および資格証明ソースを確認します。

2. 資格証明名の横にある「編集」アイコン をクリックします。

3. 「資格証明の指定」ダイアログ・ボックスで、次のいずれかのオプションを選択します:

   オプション	使用条件
   OCIボールトの資格証明	データベース資格証明は、OCI Vaultに名前付き資格証明として格納されます。
   管理エージェントの資格証明	データベース資格証明は管理エージェントに登録されます。

4. 「OCI Vaultからの資格証明」を選択した場合は、既存の名前付き資格証明を選択するか、作成してください。作成するには、OCI Vaultでの名前付き資格証明の作成を参照してください。

   「管理エージェントからの資格証明」を選択した場合は、管理エージェントに登録されている資格証明名を入力します。

   「Set credential」をクリックします。

5. 「アソシエーションの編集」ダイアログ・ボックスで、「送信」をクリックします。

OCI Vaultでの名前付き資格証明の作成

必要な資格証明がOCI Vaultで使用できない場合は、アソシエーションの構成または編集中に名前付き資格証明を作成できます。

1. 「資格証明の指定」ダイアログ・ボックスで、「OCI Vaultからの資格証明」を選択します。

   「名前付き資格情報の作成」をクリックします。

2. 「新しい名前付き資格証明の追加」ダイアログ・ボックスで、コンパートメント、管理エージェントおよびエージェント・ホストの詳細を確認します。

   名前付き資格証明は、選択したエンティティのスコープにある管理エージェントに対して作成されます。

3. 「資格証明名」に、資格証明の名前を入力します。

   オプション: 「説明」に、説明を入力します。

4. 「資格証明のタイプ」で、次のタイプのいずれかを選択します。

   資格証明のタイプ	説明
   データベース資格証明	データベース・ユーザー名およびパスワードを含むデータベース資格証明に使用します。
   Autonomous Databaseのデータベース資格証明(mTLSを使用)	mTLSを必要とするAutonomous Database接続に使用します。

   選択した資格証明タイプに必要な資格証明値を指定します。

5. オプション: 「拡張オプションの表示」を展開し、データベース接続に必要な追加の値を指定します。

   「保存」をクリックします。

6. 「資格証明の指定」ダイアログ・ボックスで、作成した名前付き資格証明を選択します。

   「Set credential」をクリックします。

7. 「アソシエーションの編集」ダイアログ・ボックスで、「送信」をクリックします。