2009 Oracle Corporation Proprietary and Confidential

Streams Health Check Script Report: How to generate

and relevant interpretation hints
Upcoming live webcasts and recent recordings:
Teleconference Access:
US & Canada: 888-2594812
Toll Number: 706-679-4880
International Toll-Free:
See DOC#1148600.1

Password: advisorpg

February 22, 2012: Improving the Performance of

Hyperion Financial Management
February 23, 2012: Understanding the Various Enterprise
Manager 12c Upgrade Methods
February 23, 2012: Check Urself B4 U Wreck Urself: A
Lesson in Using Financial Integrity Tests
February 28, 2012: ASM Install Best Practices

Current Advisor Webcast

Schedule DOC#740966.1
Archived Advisor
Webcasts
DOC#740964.1

February 28, 2012: Helper Classes and the Job Manager

using the P6 Integration API
February 29, 2012: Introduction to Upgrading SSO 10g to
Identify Access Management 11g
March 1, 2012: Diagnosing ORA-4031 Errors with the
New ORA-4031 Troubleshooting Tool China Session 1
March 5, 2012: JD Edwards EnterpriseOne: E1 and LDAP
Overview

2012 Oracle Corporation Proprietary and Confidential

Safe Harbor Statement

The following is intended to outline our general
product direction. It is intended for information
purposes only, and may not be incorporated into
any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be
relied upon in making purchasing decision. The
development, release, and timing of any features
or functionality described for Oracles products
remains at the sole discretion of Oracle.

2012 Oracle Corporation Proprietary and Confidential

<Insert Picture Here>

Streams Health Check Script Report: How to

generate and relevant interpretation hints
Daniel de Julin
Senior Principal Technical Support Engineer

AGENDA

What is the Streams HC script?

Run and modify Streams HC
Navigating on Streams HC report
Streams HC Report Generic
Streams HC Report Capture Site
Streams HC Report Apply Site
Q&A

2012 Oracle Corporation Proprietary and Confidential

What is Streams Health Check Script?

Streams Health Check Script is a sql file that contains
a set of queries and anonymous blocks that obtain
current information about Streams components in the
database where it is executed.
Streams HC does not alter or changes Streams
configuration.
Streams HC script can be downloaded from My
Oracle Support Doc ID 273674.1
There is one specific Streams HC for every specific
release.
Streams HC execution generates an html file that can
be reviewed with a browser. Assure to spool the
execution.
2012 Oracle Corporation Proprietary and Confidential

Run and Modify Streams HC

Initially Streams HC should be run on all databases
conforming streams environment.
The Streams HC output can be used to review the
current situation or to check how the Streams is
flowing by comparing different reports.
As it is sql file, you can check the contents of the
script and if required customize to adjust your
configuration needs.
There are some sections/queries that can return a
large amount of rows, they can be commented out if
required.
By default it is executed as sysdba as it checks some
memory structures.
2012 Oracle Corporation Proprietary and Confidential

Navigating on Streams HC report

First information to check is about the report itself

Links are generated in the report for a fast navigation.
Links are grouped in three groups:
Configuration, where we you see definitions or static
information.
Analysis, where you can see the results of checks that scripts
run and some historical information.
Statistics, where you can check the statistics for processes
that are currently up.

2012 Oracle Corporation Proprietary and Confidential

Streams HC Report - Generic

Configuration
Database, includes sections about database, instances, NLS
database settings, key init.ora parameters..
Queue, allow you to check which is the owner instance (in the case
this is a RAC).

Statistics
Queue, provides information about the number of messages in the
queue and if they have been spilled.

2012 Oracle Corporation Proprietary and Confidential

Streams HC Report - Generic

Analysis
Notifications, will put a message if there is any issue that may
avoid that Streams flows properly.
Configuration, will warn if there is any wrong configuration
and perform some configuration suggestions that may
improve performance.
Performance, will write a message if performance threshold
have been exceeded.
Wait Analysis, will show, per streams component process
started, the wait percentage on a specific wait event. The
scope of percentage is limited to last 30 minutes. Only
process started will be listed.

2012 Oracle Corporation Proprietary and Confidential

10

Streams HC Capture site - Configuration

Section Minimum Archive Log Necessary to Restart
Capture will help to identify the achievers that can
not be deleted.
Applied SCN is the lowest scn of all apply sites.
If there is a significant difference between Applied
SCN and Last Enqueued SCN, then there is a
problem at any apply site.
Using capture_scn and information at Registered Log
Files for Capture section will help to identify how
many achievers still need to be mined.
For downstream environments assure that source site
archivers are visible on Registered Log Files for
Capture section.
2012 Oracle Corporation Proprietary and Confidential

11

Streams HC Capture site - Statistics

Replication between 11g databases should have
CCA enabled.
Buffered publishers sections allows to monitor how
many messages have been enqueued per CP
process.
Open Streams Capture transactions is used to
monitor potential large/long running transactions.
Propagation has two faces Sender on Capture site
and Receiver on Receiving site.
It is expected to see a buffered propagation and a
persistent propagation per propagation enabled.
Persistent propagation should have all statistics to 0.
2012 Oracle Corporation Proprietary and Confidential

12

Streams HC Apply site - Configuration

On Apply Tag column you can verify if the tag that is
being used is correct.
In this section you can also verify positive and
negative rulesets used by apply. You should consider
removing the positive ruleset if the apply will
unconditionally apply all the changes that receive.
The column applied_message_number on Apply
progress section, is the source scn of last message
that has been effectively applied or apply spilled.
Propagation configuration is only applicable on
sending site, not receiving site.

2012 Oracle Corporation Proprietary and Confidential

13

Streams HC Apply site - Statistics

There are separate statistics for propagation receiver,
apply reader, apply coordinator and apply server.
It is not desirable to see entries on Apply spilled
transactions at apply reader statistics section. If so,
an action must be executed to avoid them.
On apply server statistics, we can see the waits that
every apply server has had and what is the current
transaction that the apply server is applying.
Open Streams Apply Transactions, lists the
transactions that all apply processes are managing.
The apply error queue lists failed transactions in the
order that they must be solved to avoid snowballs.
2012 Oracle Corporation Proprietary and Confidential

14

 2012 Oracle Corporation Proprietary and Confidential

15

THANK YOU

2012 Oracle Corporation Proprietary and Confidential

16