Configure Universes

22
apmdevops106
HID_Configure_Universes
2
2
Universes
Universes let the administrator refine the number and types of components into easy to use groups. This refined group is a universe. For security reasons, there is no default assignment to all users. To view Application Performance Management (APM), each user must be allocated to a universe. If no universe is associated with the user ID, the user is warned. As an administrator, create universes for users. Use the default universe that is created for every connected provider, or, create a custom universe.
The administrator performs the following tasks to configure universes:
  • Creates a universe to the needs of a user or a group.
  • Applies a Filter to remove unwanted component data from the data set.
  • (Optional) Creates numerous universes to create a series of manageable spaces. Users can easily switch between the spaces to make navigation of the Environment easier.
  • (Optional) Ensures that specific user access is restricted as required by company security requirements.
: Create universes that are based on existing domains. Create a filter that is based on the agentDomain attribute, select the domain that you require, and select
Save
.
As an APM administrator, assign at least one universe to each user so they can access content.
A universe consists of:
  • A name – A unique identifier
  • A filter – Defines the Team Center data set
  • A list of users – Users with access to this universe
Predefined Universes
Some universes are created by default:
  • A universe is created automatically that contains all components for a host.
    Host universes are named in a format "
    hostname
    components"
    .
  • The ‘Enterprise’ Universe includes all components in the environment. Use this universe as a starting point for creating universes.
:
Transaction Paths
APM generates map data by sampling transaction traces. A record exists for every transaction path that passes through any component. Any transaction that is not recorded as a Business Transaction is recorded as an Application Transaction path.
Transaction Path Filter
A transaction path filter identifies all components in all transaction paths that pass through a component with attribute values. The attribute values are specified in the filter criteria. Example: Set the filter criteria Location = London and Owner = Steve. You see all components in all transactions that go through a component that is located in London and owned by Steve. Set Transaction Path Filters in the filter drop-down bar. For more information, see Identify Areas of Concern Using Filters.
The following diagram shows an example of a transaction path for attribute Location: Paris.
Transaction Path Example...
Transaction Path Example...
 Two different use cases are available for creating universes:
  • Create a universe for navigation
    Create universes for navigation to provide users with a series of pre-configured filtered environments. Users can switch between the environments to view different areas of a complex environment quickly.
  • Create a universe for security
    Create universes for security to restrict the components of the environment that an individual user can view. We recommend that you base the content of a security universe on transaction paths. We recommend that you create custom attributes at boundaries that enable analysts to identify the continuation of the path. If your environment uses domains, the agentDomain attribute is populated by default. Use the agentDomain attribute as a filter condition to create a universe that matches the permissions restrictions of the specified domain.
Create a Universe
Follow these steps:
  1. Consider the content that you want to define in this universe.
  2. Select
    Universes
    in the left pane and then select
    Create Universe
    .
    A dialog pane opens.
  3. Assign a name to the new universe and select a filter layer. For more information about layers, see Map Layers.
    A new universe row appears.
  4. Select the plus icon under the universe name to add a filter that includes the content that you identified.
    Your filter definition can include any combination of transaction path filters and attribute filters.
  5. (Optional) Select
    Include experience node
    to add the experience node to the universe. For more information about the experience node, see Monitor Performance Using Experience View.
  6. Select
    Save
    .
    Select
    Preview Map
    to view the included content on the Map before saving. Add or remove filters as necessary, then select
    Save Universe
    .
  7. (Optional) Select the plus icon in the Users and groups column to assign analysts to the new universe.
As an administrator, you can also create a universe directly from the Map in the 'Enterprise' Universe. Define the map filters and select
Save as Universe
in the top-right corner to save the current filtered map nodes as a universe.
Modify a Universe
Follow these steps:
  1. Select
    Universes
    in the left pane.
  2. Identify the universe that you want to modify.
  3. (Optional) To modify the name of a universe, select
    Rename
    .
  4. Select
    Edit
    .
    You cannot change the filter layer on an existing universe. Create another universe with the correct filter layer.
  5. Adjust filters or remove nodes.
    To retain your current filters and add new ones, you must select Add
    Current Selection to Filter
    . For more information, see KB000115225: Problem with Adding Components after Creating new Universe.
  6. Select
    Save
    .
    Select
    Preview Map
    to view the included content on the Map before saving. Add or remove filters as necessary, then select
    Save Universe
    .
    You modified a universe.
Delete a Universe
Follow these steps:
  1. Select
    Universes
    in the left pane.
  2. Identify the universe that you want to remove and select
    Delete
    .
    A dialog pane opens.
  3. Confirm the deletion.
Assign Analysts to Universes
Users names and groups are defined, based on the security implementation that is used for the specific APM installation. Add users and groups to universes. Validation compares the user ID entered with entries in the configured realms. If you cannot verify the entry, it might not exist or your identity provider does not provide this service.
Follow these steps:
  1. Select
    Universes
    in the left pane.
  2. Select the plus icon in the Users column.
    The
    Manage Access
    dialog appears.
  3. Select the access level for the new user.
  4. Enter the ID of the user or group.
  5. Validate the ID. Select the binoculars symbol in the text box.
    The checkmark indicates that the ID is valid. the exclamation symbol indicates that the ID cannot be found.
  6. If the ID is valid, select
    Add
    .
    The ID appears in the table of
    Authorized Users and Groups
    .
  7. If the ID is not found, you can add this ID as a new user or group. The Grant Access dialog appears. Select
    User
    or
    Group
    .
    The new ID appears in the
    Authorized Users and Groups
    table.
  8. Select
    Save
    .
    Users can access their newly assigned universe immediately.
Edit Universe Users
You can add users to a universe and change universe permissions.
Follow these steps:
  1. Select
    Universes
    in the left pane.
  2. Select the plus icon in the
    Users and groups
    column.
    The
    Manage Access
    dialog appears.
  3. Select one of the following access options:
    • Read
      Lets users see the universe in APM.
    • Edit
      Lets users see the universe and modify it in APM.
    • Manage
      Lets users modify attributes and assign privileges to other users.
  4. Enter the user or group name and select
    Add
    .
    The new user or group appears in the Authorized Users and Groups section.
  5. Select
    Save
    .
Delete Users
Follow these steps:
  1. Select the plus icon in the Users column.
    A dialog pane opens.
  2. To remove user names, select the trash can icon.
  3. Select
    Save
    .