Oracle Cloud Infrastructure Documentation

Creating an Instance

Create an instance in Resource Analytics.

  • Note

    This procedure documents the guided walkthrough that Resource Analytics provides to help you create an instance. Some of the following steps let you select existing resources or create new ones. If you lack the required permissions to create resources, your tenancy administrator can grant them or else they can create the resources for you.
    1. Navigate to the compartment where you want to create a Resource Analytics instance.

      Use a compartment that's not your tenancy's root compartment. See Select or Create a Compartment.

    2. From the Console menu, navigate to the OCI Resource Analytics Console Overview page (OC1 realm).
      Tip

      In the Get started region under Before creating an instance, select Learn more to get a brief overview of the process to create an instance.
    3. To create a Resource Analytics instance, select either Create instance in the page header or Create an instance in the Get started region.

    Basic information

    Enter basic information about the instance.

    1. On the Create Resource Analytics instance page, enter a Name for the instance.
      The service host tenancy is automatically added to the list of tenancies.
    2. (Optional) Give the instance a Description.
    3. (Optional) Select the compartment for the instance.
      The one you selected when signing in to Resource Analytics is selected by default.
    4. (Optional) Add tags:
      1. (Optional) Select a Tag namespace from the list.
      2. Enter a Tag key.
      3. Enter a Tag value.
      4. Select Add tag.
      5. (Optional) Repeat the previous four steps to add another tag.
    5. Select Next.

    Access and networking

    Configure the dynamic group, policy, and network resources required by Resource Analytics. In the following steps, you can either create new resources (if you have the required permissions) or select existing ones (if you have already worked with your tenancy administrator to create them).

    1. In the Dynamic group region, select either Create a new dynamic group or Select an existing dynamic group.

      Resource Analytics requires a dynamic group in a designated compartment/domain with a matching rule in order to read your resource metadata.

      • Create a new dynamic group: select the compartment and domain where the dynamic group will be created.

        A preview displays the dynamic group and matching rule that will be created.

        If you're happy with the preview, select Create dynamic group.

      • Select an existing dynamic group: select a compartment and domain, and then select an existing dynamic group.
    2. In the Policy region, select either Create a new policy or Select an existing policy.

      Resource Analytics requires policy statements that let the dynamic group observe and report the metadata for resources in your tenancy.

      • Create a new policy: a preview displays the details about the policy that will be created.

        If you're happy with the preview, select Create policy.

      • Select an existing policy: select an existing policy from the list.
    3. In the Network region, select either Create new network resources or Select existing network resources.

      You must have a VCN and subnet to use for the Resource Analytics instance.

      • Create new network resources: a preview displays the details about the network resources that will be created, including VCN, subnet, security list, and other associated configurations.

        If you're happy with the preview, select Create network resources.

      • Select existing network resources: select existing network resources, including the VCN compartment, VCN, Subnet compartment, and Subnet.
        • (Optional) Use the toggle switch to use network security groups.
          1. Select a NSG from the list.
          2. Select Add NSG.

            You can add up to four more NSGs.

    4. Select Next.

    Resource Analytics configuration

    Configure additional settings for your Resource Analytics instance.

    1. Under Subscribed Regions - Confirm Data Collection, select the regions to collect data from.
      • Select All Subscribed Regions to select all regions.
      • Select Only Certain Subscribed Regions and then select regions from the Included Regions list.
      Note

      The host tenancy must be subscribed to all the regions that any other tenancies added in the previous step are subscribed to. For more information on subscribing to regions, see the IAM documentation.
    2. Under Oracle Autonomous AI Database, select the configuration options for the Oracle Database instance that Resource Analytics provisions to store your data.

      First, create a password for the administration user for ADW provisioned by Resource Analytics, or use Vault.

      • To enter a password, select Input password:
        1. Enter the password in Password.
        2. Enter it again in Confirm password.
      • To use Vault, select Use OCI Vault:
        1. Select the compartment containing the vault.
        2. Select the vault.
        3. Select the secret.
      • Enter the ECPU count for your ADW.

        This is the compute amount (CPUs) available to the Autonomous AI Database. You can enter a count from 2 to 512.

        Note

        To help you set the most appropriate ECPU count for your needs, consider the following:

        • On initial bootstrap data ingestion, the lowest ECPU count of 2 will likely deliver a potential increase in latency of up to 50%.
        • After that, at this minimum level, the Resource Analytics instance can typically fulfill up to 1,000 resource changes per minute. Larger workloads will require additional ECPUs.

        For more information, see Scale Up Oracle Autonomous Data Warehouse.

      • (Optional) Use the toggle switch to require mutual TLS authentication.
      • (Optional) Use the toggle switch to bring your own license.
    3. (Optional) Under Oracle Analytics Cloud , use the toggle switch to provision an instance of Oracle Analytics Cloud.
      1. Select the compartment containing the IDCS domain.
      2. Select the IDCS domain.
      3. Under Capacity Type, select the capacity model to use for your Oracle Analytics Cloud instance:

        Your selection affects the number of OCPUs, amount of memory, and other resources allocated to the Oracle Analytics Cloud instance.

      4. If you selected OCPU, then under License Type, you can select either License included or Bring your own license (BYOL).

        If you selected Users, then License included is the only option.

      5. Under Network Access, select Public or Private access to OAC.
      6. (Optional) Use the toggle switch to use network security groups.
        1. Select a NSG from the list.
        2. Select Add NSG.

          You can add up to four more NSGs.

      7. (Optional) Use the toggle switch to bring your own license.
    4. Select Next.

    Review and create

    The Review and create page displays the selections you've made to configure a new instance of Resource Analytics.

    1. Select Create instance to create the new instance of Resource Analytics.
    2. Select Cancel if you don't want to proceed.
      Note

      If you cancel, no Resource Analytics instance is created and all selections from this session are lost. However, if any prerequisites were created, such as a new dynamic group or new policy, they still exist and can be selected if you try again later.

  • Use the resource-analytics-instance command and required parameters to create an instance:

    oci resource-analytics resource-analytics-instance create [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.

  • Run the Resource Analytics Instance Resource Creation operation to create an instance.