8 Troubleshooting

When working with large applications, it is very common to encounter problems. You must be aware of the commonly faced problems and workarounds to overcome those issues.

Visit http://www.oracle.com/technetwork/middleware/insight/customers/index.html#FAQ for a list of Frequently Asked Questions.

Why Can't I See A Model on My Home Page?

Models that are created in Oracle Real-Time Integration Business Insight conform to the model lifecycle. When models are created or edited, they are in Draft state until they are Activated. Activation is the action that pushes a model definition (including milestones, indicators, mappings, etc.) out to the various runtime engines (i.e., SOA Suite and Service Bus). There are other model states as well, representing deactivation, error, and other conditions.

Models are available to add to the Home page only when they are activated. If you are expecting to be able to add a model to your Home page, but it is not listed in the model selector, then the most likely cause is that the model has not been activated. Contact the appropriate architect or an administrator and request that the model be activated.

Why Did My Model Deactivate?

Models that are created in Oracle Real-time Integration Business Insight conform to the model lifecycle. After models are activated, they remain activated until a business user, architect, or an administrator explicitly deactivates them. Models may also be deactivated automatically by the system if certain error conditions are detected by the system.

The system automatically deactivates a model when error conditions exist that could result in inaccurate collection of metrics for that model. Examples of such errors include an administrator deploying a new version of an application (a new revision of a composite) that is not compatible with the mappings defined in an activated mode, and network failure inhibiting recording of metrics from distributed components of an application.

Why Can't I Map My Model?

There are three reasons why you may not be able to create mappings for milestones and indicators in your model.

  1. The most common reason is that a user may not be assigned to the appropriate persona, or role. A user must be assigned to the InsightIntegrationArchitect, InsightAdmin, or InsightModelCreator role in order to map milestones or indicators to implementation. If you are only assigned to the InsightBusinessUser role, you will be able to define the abstract elements of milestones and indicators (e.g., name, type), but you will not be able to do mappings.

  2. The second most common reason that a user may not be able to create mappings for a model is that it is not in draft mode. Only drafts of a model can be edited. If you are viewing an activated version of a model, you will not be able to modify it, including creating new mappings for a milestone or indicator.

  3. The third most common obstacle to creating mappings is that the connections used to browse application artifacts (e.g., composites or service bus project) and mapping may not have been properly set up. In this case, contact your administrator to create, configure, and test the necessary SOA Suite or Service Bus connections so that you can create mappings for your model elements.

See also:

Why Is My Model Stuck?

Instances of a model may stop progressing through milestones for a number of different reasons. Use this information as a starting point to work with your administrator to understand why your instances are not hitting the milestones that you think they should.

The most likely reason instances for a model to stop progressing is that the model has been deactivated, either explicitly by a business user, architect or administrator, or automatically by the system. See Why Did My Model Deactivate?.

The other likely reason that a model is not progressing is that milestones are improperly mapped to underlying implementation. For example if you are expecting a milestone representing “Order Shipped” to be passed frequently in your order processing application, but your orders seem to be “stuck” at the previous milestone, then it is possible that the Order Shipped milestone was associated with an incorrect service, BPEL activity, or Service Bus project artifact that does not really represent the order being shipped. Work with your business user and architect to verify the mappings.

Why Can't I Find My Instance?

In this release of Oracle Real-Time Integration Business Insight, you can only search for model instances by identifier values. For example, if you have modeled a Help Desk application, and used Incident ID as the identifier for the model, you would be able to search for a single Help Desk engagement by Incident ID.

It is worth noting that you can also filter a list of instances by criteria beyond just the identifier, and this can be helpful in finding instances. Any indicator that is marked as filterable in the model is available to use as filter criteria when viewing an instance list. For more information, see Filtering Instances.

Why Can't I Use My Connections to Map Milestones?

When mapping your model to an underlying implementation, architects use connections to runtime engines such as SOA Suite and Service Bus. The connections are listed in the mapping user interface. These connections are created and configured by administrators. If a connection has not been completely configured or tested, it is possible that architects will not be able to browse the runtime engine associated with that connection. Work with your administrator to validate that connections are configured properly and have been tested.

Another reason might be that the runtime engine associated with a connection is offline. For example, if a SOA Suite server has been taken offline for maintenance, an architect will not be able to browse that server and map milestones until the server is brought back online.

Why Can't I See the Console Tab?

If you expect to see the Consoles tab, but it is not listed at the top of your screen, then you have not been assigned to the appropriate application role.

Users must be assigned to the InsightExecutive, InsightAdmin, or InsightModelCreator role in order to see the Consoles tab.

See also:

Why Are My Dashboards Empty?

After a model has been defined by a business user and mapped to implementation by an architect, the model must be activated to begin collecting metrics and observing the passage of milestones.

Depending on the activity level of your application, it may take some time to begin to see instances and indicators populated in the console. For example, if your have created a model of an order processing system and your application typically processes several orders per minute, you should start to see your consoles populate within a few minutes. However, if your application typically receives an order every hour, it may take several hours for your console to begin to show meaningful data.

There is very minimal delay between metrics being collected on runtime engines and information showing up in your consoles. The product has been optimized to minimize performance impact on runtime engines, so during times of heavy runtime load, you may see delay of a few minutes, but generally not more than this.

How Are My Metrics Impacted When I Change My Model?

The metrics being collected for a model are impacted when you either add/remove a milestone or an indicator to/from the model.

The following is the impact in different scenarios:

  1. If a milestone is added while metrics are being collected, new Insight instances created after activation, will start collecting data for the new milestone. The existing metrics are unaffected.

  2. If a milestone is deleted while metrics are being collected, the existing metrics collected for the deleted milestone are lost. The existing instance depict that the milestone was never reached. You will also get notified through a warning message about such changes upon re-activation of the model.

  3. If an indicator is added while metrics are being collected, there is no impact on the existing metrics. The new Insight instances will start collecting metrics for the new indicator upon re-activation of the model.

  4. If an indicator is removed while metrics are being collected, the existing metrics collected for the indicator will be lost. On activating the model with a deleted indicator, you will be presented with a list of consoles where the indicator is being used. You must remove such consoles or remove the usage of the indicator from those consoles to proceed with activation of model.

For more information, see Impact of Reactivation of Model After Changes in Model Metadata in Oracle Fusion Middleware Oracle Real-Time Integration Business Insight Concepts.

Why Does the Metric Collection Stop for My Service Bus Model?

Collection of metrics suddenly stops for the Service Bus models when there is any change to the Service Bus project like changing project variables or redeploying/re-importing the Service Bus project. As there is no way of indicating to the user and the model about the change to the Service Bus project redeployment/component changes, the user must rebuild/remap the model with the updated project path.

When you rebuild/remap the model, the metrics are collected.