Using Service Instance Manager

Page last updated:

This topic describes how to use Service Instance Manager to view and delete service instances across foundations.

Log in to Service Instance Manager

Follow the steps below to log in to Service Instance Manager.

  1. Open a web browser and go to https://service-instance-manager.YOUR-FOUNDATION-URL.

  2. Log in with the email address and password you use for that foundation.

    Cloud Foundry login page

    • If this is the only foundation that Service Instance Manager is configured to target, the Service Instance Manager UI appears.
    • If Service Instance Manager is configured to target any other foundations, you are redirected to the login page for the next foundation listed in config.json. Redirects continue until you have logged in to every foundation that Service Instance Manager targets.
  3. Log in to each foundation until the the Service Instance Manager UI appears.

Filter Service Instances

You can filter service instances by a variety of properties.

  • To filter by service instance name or GUID, enter a name or GUID in the search field.

    A name in the search field

  • To filter by a category, enter the query in the search field in the format FILTER:VALUE, or filter by clicking on a filter tag below the search field.

    Status filter in the search field

    The available filters and their associated tags are shown in the table below.

    Searching by… Type or Click Filters for instances that…
    app:BOUND-APP-NAME Either type the filter or click the tag Have the specific app bound to them.
    For example: app:go-app-45
    foundation:FOUNDATION-NAME Either type the filter or click the tag Are in a specific foundation.
    For example: foundation:Bluemonday
    org:ORG-NAME Either type the filter or click the tag Are in a specific org.
    For example: org:acceptance

    space:SPACE-NAME
    Either type the filter or click the tag Are in a specific space.
    For example: space:acceptance
    service:SERVICE-OFFERING-NAME Either type the filter or click the tag Are of a specific service offering.
    For example: service:p-redis
    plan:PLAN-NAME Either type the filter or click the tag Are of a specific service plan.
    For example: plan:standard
    status:ok Type the filter The last operation succeeded.
    status:error Type the filter The last operation failed. The status of these instances can be one of:
    • create failed
    • delete failed
    • update failed
    failing Click the tag The last operation failed. The status of these instances can be one of:
    • create failed
    • delete failed
    • update failed
    keys:true Type the filter Have service keys.
    keys:false Type the filter Do not have service keys.
    bindings:true Type the filter Are bound to apps.
    bindings:false Type the filter Are not bound to apps.
    unbound Click the tag Do not have service keys and are not bound to apps.
    younger_than: Type the filter Were created before a specific time. You can filter by:
    • Years: y
    • Months: m
    • Weeks: w
    • Days: d
    For example: younger_than:4y2m
    older_than: Type the filter Were created after a specific time. You can filter by:
    • Years: y
    • Months: m
    • Weeks: w
    • Days: d
    For example: older_than:2w6d


    You also can combine the above filters to further narrow your search.

    For example:

    foundation:Bluemonday older_than:2w6d
    

    Note: status, keys, and bindings can only be used with the values shown in the Searching by… column.

View Consumption of Service Instances

The Service Consumption Dashboard provides a filtered overview of your foundations and service instances. The dashboard is made up of summary boxes and a graph. By default, the graph shows a summary of the bound states of instances by foundation.

To view a summary of instance consumption:

  1. (Optional) To filter service instances, see Filter Service Instances above.
    This changes the summary boxes, which provides information about:

    • Foundations: This is the total number of foundations.
    • Orgs: This is the total number of orgs.
    • Offerings: This is the total number of available service offerings.
    • Instances: This is the total number of instances.
    • Unbound: This is the total number of unbound instances.
    • Failed: This is the total number of failed operations.
  2. Select an option from the For each dropdown.
    You can group the bars by:

    • Foundation: This shows the consumption of instances by foundation.
    • Org: This shows the consumption of instances by org.
    • Service offering: This shows the instances of a given service offering.
    • Bound state: This shows the number of bound and unbound instances.
    • Last operation status: This shows the number of running and errored instances.
  3. Select an option from the Show dropdown.
    You can segment the bars to show:

    • Service offering
    • Bound status
    • Last operation status
  4. Click on a bar to apply the filters and restrict the search results to that subset of service instances.

The animated GIF below shows the Service Consumption summary boxes and graph.

Service Consumption summary

See a larger version of this animated GIF.

Delete Service Instances

Service Instance Manager enables you to either delete individual service instances or delete multiple service instances based on a search or filter. You cannot delete service instances with service bindings, service keys, or route associations.

To delete service instances:

  1. Filter for service instances without service bindings, service keys. You can filter further if necessary. For instructions on how to use these filters others, see Filter Service Instances above.

  2. Use the checkboxes to select the instances you want to delete.

  3. Click DELETE.

  4. Click DELETE in the delete service instance dialog box. Delete dialog