Oracle Cloud Infrastructure

概要

Oracle Cloud Infrastructure (OCI) は、エンタープライズ規模の企業で使用されるInfrastructure-as-a-Service (IaaS) および Platform-as-a-Service (PaaS) です。ホスティング、ストレージ、ネットワーキング、データベースなどのマネージドサービスの完全なスイートを備えています。

Datadog の OCI インテグレーションを使用して、ログとメトリクスを Datadog に転送し、ダッシュボードの作成、トラブルシューティングの支援、セキュリティおよびコンプライアンス状況の監視に活用できます。

セットアップ

メトリクスの収集

OCI メトリクスを Datadog に転送するには

OCI スタックとテナンシー情報を作成する

注: これらの手順を完了するには、OCI ユーザーアカウントに Cloud Administrator ロールが必要です。

このインテグレーションは、OCI のコネクタハブ、関数アプリ、およびセキュアなネットワークインフラストラクチャーを使用して、OCI メトリクスを Datadog に転送します。

このページで言及されている OCI リソースとデータフローを示す図

最も簡単なセットアップのために、Datadog は以下の ORM スタックを使用して、必要なすべての OCI リソースを作成することを推奨します。あるいは、既存の OCI ネットワークインフラストラクチャーや、メトリクス転送スタックを作成するで概要を説明する要件を満たす関数アプリを使用することもできます。

注: リソースマネージャースタックの Terraform 状態ファイルへのアクセス権を管理する必要があります。詳細については、Securing Resource Manager ページの Terraform 状態ファイルのセクションを参照してください。

ポリシースタックを作成する

インテグレーション認証に使用される OCI リソースとワークフローの図

ORM ポリシースタックは、テナンシーのホームリージョンに作成する必要があります。このポリシースタックは次を作成します。

  • コネクタハブへのアクセスを有効にするための resource.type = 'serviceconnectors' を持つ動的グループ。
  • テナンシーリソースを読み取るために Datadog が使用する DatadogAuthUser というユーザー。
  • 作成されたユーザーがポリシーアクセスのために追加されるグループ。
  • ルートコンパートメントにおける、コネクタハブがメトリクスを読み取り、関数を呼び出すことを許可するポリシー。さらに、作成されたユーザーグループにテナンシーリソースの読み取りアクセスを付与します。ポリシーに以下のステートメントが追加されます。
Allow dynamic-group <GROUP_NAME> to read metrics in tenancy
Allow dynamic-group <GROUP_NAME> to use fn-function in tenancy
Allow dynamic-group <GROUP_NAME> to use fn-invocation in tenancy
Allow group <DOMAIN>/<USER_GROUP_NAME> to read all-resources in tenancy

スタックを作成するには、ユーザーアカウントが動的グループとポリシーを作成できる必要があります。

  1. Datadog OCI インテグレーションタイルで Create a stack ボタンをクリックします。
  2. Oracle 利用規約に同意します。
  3. Working directory のドロップダウンで、datadog-oci-orm/policy-setup を選択します。
  4. カスタム Terraform プロバイダーを使用するオプションは未選択のままにします。
  5. datadog-metrics-policy-setup のようなわかりやすい名前を提供し、それをデプロイするコンパートメントを選択します。
  6. Next をクリックします。
  7. 作成される動的グループ、ユーザーグループ、およびポリシーの名前を指定するか、提供されたデフォルトの名前を使用します。
  8. スタックを実行するユーザーのドメイン名を提供します。デフォルトのドメイン名は Default です。
  9. テナンシーのホームリージョンが選択されていることを確認します。
  10. Next をクリックします。
  11. Create をクリックします。

注:

  • スタックを実行するユーザーが Default 以外の IAM ドメインに属している場合、認証ユーザー、動的グループ、およびユーザーグループがそのドメイン内にのみ作成されるように、そのドメイン名を指定してください。
  • ユーザーとグループが Default ドメインに作成されていない場合、そのドメインがテナンシーのすべてのサブスクライブされたリージョンにレプリケートされていることを確認してください。詳細については、アイデンティティドメインを複数のリージョンにレプリケートするを参照してください。

テナンシー情報を入力

  1. 監視したいテナンシーの OCID とホームリージョンを Datadog OCI インテグレーションタイルに入力します。

  2. 前のスタックを実行した後に作成された DatadogAuthUser の OCID 値をコピーし、それを Datadog OCI インテグレーションタイルのユーザー OCID フィールドに貼り付けてください。

  3. OCI コンソールに戻り、次の手順で API キーを生成します。 a. 作成された DatadogAuthUser に戻ります。 b. 画面の左下の Resources の下にある API keys をクリックします。 c. Add API key をクリックします。 d. Download private key をクリックします。 e. Add をクリックします。 f. Configuration file preview のポップアップが表示されますが、特に操作は必要ありません。ポップアップを閉じてください。

OCI コンソールの Add API Key ページ
  1. Fingerprint の値をコピーし、その値を Datadog OCI インテグレーションタイルの Fingerprint フィールドに貼り付けてください。
  2. 次の手順でプライベートキーの値をコピーします。 a. ダウンロードしたプライベートキー .pem ファイルをテキストエディタで開くか、cat のようなターミナルコマンドを使用してファイルの内容を表示します。 b. -----BEGIN PRIVATE KEY----- と -----END PRIVATE KEY----- を含む全内容をコピーします。
  3. プライベートキーの値を Datadog OCI インテグレーションタイルの Private Key フィールドに貼り付けてください。

メトリクス転送スタックを作成する

このスタックで作成されたすべてのリソースは、指定されたコンパートメントにデプロイされます。このスタックを実行するユーザーが、そのコンパートメントでリソースを作成するアクセス権を持っていることを確認してください。

  1. OCI コンソールのスタックの作成に移動します。
  2. Oracle 利用規約に同意します。
  3. Working directory のドロップダウンで、datadog-oci-orm/metrics-setup を選択します。
  4. カスタム Terraform プロバイダーを使用するオプションは未選択のままにします。
  5. スタックに名前を付け、それをデプロイするコンパートメントを選択します。
  6. Next をクリックします。
  7. Tenancy の値は、そのままにしておいてください。これらは現在のリージョンとテナント、および以前に選択したコンパートメントによって指定されます。
  8. Datadog API Key フィールドにあなたの Datadog API キーを入力します。
  9. Datadog Environment Endpoint フィールドで、あなたの Datadog サイトに対応するエンドポイントを選択します。
Datadog サイトエンドポイント
US1ocimetrics-intake.datadoghq.com
US3ocimetrics-intake.us3.datadoghq.com
US5ocimetrics-intake.us5.datadoghq.com
EU1ocimetrics-intake.datadoghq.eu
AP1ocimetrics-intake.ap1.datadoghq.com

注: OCI インテグレーションは US1-FED サイトではサポートされていません。

    1. Network options セクションで、Create VCN がチェックされたままにします。 a. vcnCompartment フィールドで、あなたのコンパートメントを選択します。

    既存の VCN を使用する場合、サブネットの OCID をスタックに提供する必要があります。VCN が次を満たしていることを確認してください。

    • NAT ゲートウェイを通じて HTTP の外向きコールを行うことが許可されている。
    • サービスゲートウェイを使用して OCI コンテナレジストリからイメージを取得できる。
    • NAT ゲートウェイとサービスゲートウェイを許可するルートテーブルルールを持っている。
    • HTTP リクエストを送信するセキュリティルールを持っている。
    1. Network options セクションで、Create VCN オプションのチェックを外し、あなたの VCN 情報を入力します。 a. vcnCompartment フィールドで、あなたのコンパートメントを選択します。 b. existingVcn セクションで、あなたの既存の VCN を選択します。 c. Function Subnet OCID セクションで、使用するサブネットの OCID を入力します。

      ORM スタックは、テナンシー内のリージョンに関数コンテナリポジトリを作成し、関数で使用するために Docker イメージがそこに送信されます。

      1. Function settings セクションで以下の手順を完了します。 a. Function Application shape フィールドで、値を GENERIC_ARM のままにします。 b. OCI Docker レジストリのユーザー名とパスワードを入力します。

        • OCI Docker registry user name フィールドに、あなたの OCI ユーザー名を入力します。
        • OCI Docker registry password フィールドに、あなたの OCI ユーザーの認証トークンを入力します。詳細については、認証トークンの取得を参照してください。

        注: Docker レジストリのログインが正しいかどうかを確認するには、Oracle Cloud Infrastructure Registry へのログインを参照してください。

      既存の関数アプリケーションを使用する場合、イメージはすでに存在しており、完全なイメージパスを提供する必要があります。以下は完全なイメージパスの例です。

      <REGION_KEY>.ocir.io/<TENANCY_NAMESPACE>/datadog-functions/datadog-function-metrics:latest
      1. Function settings セクションで以下の手順を完了します。 a. Function Application shape フィールドで、値を GENERIC_ARM のままにします。 b. Function Image Path フィールドに、完全なイメージパスを入力します。
      1. Service Connector hub batch size を 5000 に設定します。
      2. Next をクリックします。
      3. Create をクリックします。
      4. Datadog OCI インテグレーションタイルに戻り、Create configuration をクリックします。

      注: デフォルトでは、ルートコンパートメントのみが選択され、Datadog OCI インテグレーションでサポートされているすべてのメトリクスネームスペースが有効になっています (コネクタハブあたり最大 50 のネームスペースがサポートされます)。

      1. 任意で、コンパートメントを追加したり、有効なメトリクスネームスペースのリストを編集するには、新しく作成した Connector Hub の Edit をクリックします。
        • コンパートメントを追加するには、+ Another compartment をクリックします。
        • Configure source セクションで、Namespaces ドロップダウンからネームスペースを追加または削除します。

      検証

      Datadog の OCI インテグレーション概要ダッシュボードまたは Metrics Explorer ページで oci.* メトリクスを表示します。

      OCI 関数メトリクス (oci.faas ネームスペース) とコンテナインスタンスメトリクス (oci_computecontainerinstance ネームスペース) はプレビュー版です。

      メトリクスネームスペース

      インテグレーションメトリクスネームスペース
      Autonomous Databaseoci_autonomous_database
      ブロックストレージoci_blockstore
      コンピュートoci_computeagent、rdma_infrastructure_health、gpu_infrastructure_health、oci_compute_infrastructure_health
      コンテナインスタンス (プレビュー)oci_computecontainerinstance
      データベースoci_database、oci_database_cluster
      ダイナミックルーティングゲートウェイoci_dynamic_routing_gateway
      FastConnectoci_fastconnect
      ファイルストレージoci_filestorage
      関数 (プレビュー)oci_faas
      HeatWave MySQLoci_mysql_database
      Kubernetes エンジンoci_oke
      ロードバランサーoci_lbaas、oci_nlb
      NAT ゲートウェイoci_nat_gateway
      オブジェクトストレージoci_objectstorage
      キューoci_queue
      サービスコネクタハブoci_service_connector_hub
      サービスゲートウェイoci_service_gateway
      VCNoci_vcn
      VPNoci_vpn
      Web Application Firewalloci_waf

      ログ収集

      次のいずれかのプロセスに従って、Oracle Cloud Infrastructure から Datadog にログを送信します。

        1. OCI ログを構成します。
        2. OCI 関数を作成します。
        3. OCI サービスコネクタを設定します。

        以下の手順では、OCI ポータルを使用してインテグレーションを設定します。

        OCI ロギング

        1. OCI ポータルで、Logging -> Log Groups に移動します。
        2. コンパートメントを選択し、Create Log Group をクリックします。サイドパネルが開きます。
        3. 名前には data_log_group を入力し、オプションで説明とタグを入力します。
        4. Create をクリックして、新しいロググループを設定します。
        5. Resources の下にある Logs をクリックします。
        6. 必要に応じて、Create custom log または Enable service log をクリックします。
        7. Enable Log をクリックして、新しい OCI ログを作成します。

        OCI ログの詳細については、リソースのログを有効にするを参照してください。

        OCI 関数

        1. OCI ポータルで、Functions に移動します。
        2. 既存のアプリケーションを選択するか、Create Application をクリックします。
        3. アプリケーション内に新しい OCI 関数を作成します。詳細については、Oracle の関数概要を参照してください。
        4. 最初にボイラープレート Python 関数を作成し、自動生成されたファイルを Datadog のソースコードに置き換えることをお勧めします。

        OCI サービスコネクタハブ

        1. OCI ポータルで、Logging -> Service Connectors に移動します。
        2. Create Service Connector をクリックして、Create Service Connector ページに移動します。
        3. ロギングとして Source を選択し、関数として Target を選択します。
        4. Configure Source Connection で、Compartment name、Log Group、Log を選択します。(最初のステップで作成された Log Group と Log)
        5. Audit Logs も送信する場合は、+Another Log をクリックし、同じ Compartment を選択して、Log Group として “_Audit” を置き換えます。
        6. Configure target で、Compartment、Function application、Function を選択します。(前のステップで作成された Function Application と Function)
        7. ポリシーを作成するように求められたら、プロンプトから Create をクリックします。
        8. 一番下の Create をクリックして、サービスコネクタの作成を完了します。

        OCI オブジェクトストレージの詳細については、Oracle のサービスコネクタのブログ記事を参照してください。

        1. OCI ログを構成します。
        2. OCI オブジェクトストアを作成し、OCI ログの読み取り/書き込みアクセスを有効にします。
        3. OCI 関数を作成します。
        4. OCI イベントを設定します。

        以下の手順では、OCI ポータルを使用してインテグレーションを設定します。

        OCI ロギング

        1. OCI ポータルで、Solutions and Platform -> Logging -> Logs に移動します。
        2. Create Custom Log をクリックして、Create Custom Log ページに移動します。
        3. 新しい OCI ログに名前を付けます。
        4. Compartment と Log Group を選択します。この選択は、インストール全体で一貫しています。
        5. Create Custom Log をクリックして、Create Agent Config ページに移動します。
        6. Create new configuration をクリックします。
        7. 新しいコンフィギュレーションに名前を付けます。コンパートメントは事前に選択されています。
        8. グループタイプを Dynamic Group に設定し、グループを既存のグループの 1 つに設定します。
        9. 入力タイプを Log Path に設定し、希望の入力名を入力して、ファイルパスに “/” を使用します。
        10. Create Custom Log をクリックすると、OCI ログが作成され、ログページで利用できるようになります。

        OCI ログの詳細については、リソースのログを有効にするを参照してください。

        OCI オブジェクトストレージ

        1. OCI ポータルで、Core Infrastructure -> Object Storage -> Object Storage に移動します。
        2. Create Bucket をクリックして、Create Bucket フォームに移動します。
        3. ストレージ階層に Standard を選択し、Emit Object Events をチェックします。
        4. 好みに応じてフォームの残りの部分に記入します。
        5. Create Bucket をクリックすると、バケットが作成され、バケットリストで利用できるようになります。
        6. アクティブなバケットリストから新しいバケットを選択し、リソースの下の Logs をクリックします。
        7. read を有効に切り替えると、Enable Log サイドメニューが表示されます。
        8. Compartment と Log Group を選択します (OCI ログと同じ選択を使用します)。
        9. Log Name の名前を入力し、希望するログ保持を選択します。

        OCI オブジェクトストレージの詳細については、データをオブジェクトストレージに格納するを参照してください。

        OCI 関数

        1. OCI ポータルで、Solutions and Platform -> Developer Services -> Functions に移動します。
        2. 既存のアプリケーションを選択するか、Create Application をクリックします。
        3. アプリケーション内に新しい OCI 関数を作成します。詳細については、Oracle の関数概要を参照してください。
        4. 最初にボイラープレート Python 関数を作成し、自動生成されたファイルを Datadog のソースコードに置き換えることをお勧めします。

        OCI イベント

        1. OCI ポータルで、Solutions and Platform -> Application Integration -> Event Service に移動します。
        2. Create Rule をクリックして、Create Rule ページに移動します。
        3. イベントルールに名前と説明を付けます。
        4. 条件を Event Type*、サービス名を Object Storage、イベントタイプを Object - Create として設定します。
        5. アクションタイプを Functions として設定します。
        6. 関数コンパートメントが、OCI ログ、OCI バケット、および OCI 関数に対して行った選択と同じであることを確認します。
        7. 関数適用と関数を選択します (前のインストール手順に従って)。
        8. Create Rule をクリックすると、ルールが作成され、ルールリストで利用できるようになります。

        OCI オブジェクトストレージの詳細については、イベント入門を参照してください。

        収集データ

        メトリクス

        oci.apigateway.backend_http_responses
        (count)        		Count of the HTTP responses returned by the back-end services.
        Shown as response
        oci.apigateway.bytes_received
        (count)        		Number of bytes received by the API gateway from API clients.
        Shown as byte
        oci.apigateway.bytes_sent
        (count)        		Number of bytes sent by the API gateway to API clients.
        Shown as byte
        oci.apigateway.http_requests
        (count)        		Number of incoming API client requests to the API gateway.
        Shown as request
        oci.apigateway.http_responses
        (count)        		Number of HTTP responses that the API gateway has sent back.
        Shown as response
        oci.apigateway.integration_latency
        (gauge)        		Time between the API gateway sending a request to the back-end service and receiving a response from the back-end service.
        Shown as second
        oci.apigateway.internal_latency
        (gauge)        		Time spent internally in the API gateway to process the request.
        Shown as second
        oci.apigateway.latency
        (gauge)        		Average time that it takes for a request to be processed and its response to be sent. This is calculated from the time the API gateway receives the first byte of an HTTP request to the time when the response send operation is completed.
        Shown as second
        oci.apigateway.response_cache_action
        (gauge)        		The action taken by the response cache.
        oci.apigateway.response_cache_availability
        (gauge)        		Availability of the response cache as seen by the API gateway.
        oci.apigateway.response_cache_latency
        (gauge)        		Total time taken for connect, read, and store operations on the response cache.
        Shown as millisecond
        oci.apigateway.subscriber_quota_proportion_used
        (gauge)        		Proportion of an entitlement's quota that has been consumed by a subscriber. Emitted per request. Calculated as: / .
        Shown as fraction
        oci.apigateway.subscriber_rate_limit_proportion_used
        (gauge)        		Proportion of an entitlement's rate limit that has been consumed by a subscriber. Emitted per request. Calculated as: / .
        Shown as fraction
        oci.apigateway.subscriber_requests
        (count)        		Number of requests made by a subscriber. Emitted per request.
        Shown as request
        oci.apigateway.usage_plan_requests
        (count)        		Number of requests to a given entitlement. Emitted per request.
        Shown as request
        oci.oracle_appmgmt.active_requests_by_application
        (gauge)        		Number of executions active grouped by category.
        Shown as request
        oci.oracle_appmgmt.active_user_sessions
        (gauge)        		Current Active User Sessions by username.
        Shown as session
        oci.oracle_appmgmt.active_user_sessions_by_responsibility
        (gauge)        		Current Active User Sessions grouped by responsibility.
        Shown as session
        oci.oracle_appmgmt.capacity_utilization_of_concurrent_managers
        (gauge)        		Utilized capacity of the concurrent manager.
        Shown as percent
        oci.oracle_appmgmt.completed_requests_by_application
        (gauge)        		Percentage of executions completed grouped by category.
        Shown as percent
        oci.oracle_appmgmt.concurrent_processing_component_status
        (gauge)        		Status of the component. Values are: 1 = Up 0 = Down.
        Shown as resource
        oci.oracle_appmgmt.concurrent_requests_by_status
        (count)        		Concurrent requests by status.
        Shown as request
        oci.oracle_appmgmt.deferred_records
        (count)        		Deferred records grouped by status.
        Shown as record
        oci.oracle_appmgmt.executed_programs_by_running_time
        (gauge)        		Running time of each execution of the program (raw data).
        Shown as millisecond
        oci.oracle_appmgmt.forms_database_sessions_per_application
        (count)        		Number Of Forms Sessions.
        Shown as session
        oci.oracle_appmgmt.forms_database_sessions_per_user
        (count)        		Number Of Forms Sessions.
        Shown as session
        oci.oracle_appmgmt.hourly_completed_concurrent_requests_rate
        (gauge)        		Concurrent Requests Completed by category.
        Shown as percent
        oci.oracle_appmgmt.inbound_notifications
        (count)        		Inbound records grouped by status.
        Shown as record
        oci.oracle_appmgmt.internal_concurrent_manager_status
        (gauge)        		Status of the resource. Values are: 1 = Up 0 = Down.
        Shown as resource
        oci.oracle_appmgmt.long_active_concurrent_requests
        (gauge)        		For pending requests, pending time. For running requests, running time.
        Shown as millisecond
        oci.oracle_appmgmt.monitoring_status
        (gauge)        		Status of the resource. Values are: 1 = Up 0 = Down.
        Shown as resource
        oci.oracle_appmgmt.outbound_notifications
        (count)        		Outbound records grouped by status.
        Shown as record
        oci.oracle_appmgmt.queue_details
        (count)        		Requests grouped by status.
        Shown as request
        oci.oracle_appmgmt.users_with_most_pending_requests
        (gauge)        		Number of requests.
        Shown as user
        oci.oracle_appmgmt.users_with_most_running_requests
        (gauge)        		Number of requests.
        Shown as user

        サービスチェック

        OCI インテグレーションには、サービスのチェック機能は含まれません。

        イベント

        OCI インテグレーションには、イベントは含まれません。

        トラブルシューティング

        ご不明な点は、Datadog のサポートチームまでお問い合わせください。

        その他の参考資料

        お役に立つドキュメント、リンクや記事:

        PREVIEWING: aliciascott/DOCS-10399-move-CCM