The document summarizes new features in Oracle Trace File Analyzer (TFA) 18.2.0, including a REST service for invocation and queries, integration with Oracle Cluster Health Advisor to trigger collections on detected problems, new standardized diagnostic collection types, use of an external SMTP server for notifications, improved metadata search capabilities, and automatic setup of ORAchk on install.

1. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Oracle Trace File Analyzer (TFA)
What’s New in 18.2.0
With Database Support Tools Bundle

2. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
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 decisions. The development, release, and timing of any features or
functionality described for Oracle’s products remains at the sole discretion of Oracle.
2

3. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 3
Real-time health
monitoring, fault detection
& diagnosis via a single
interface
Secure log redaction &
collection
Continuous incident and log
lifecycle management
Top problem detection &
diagnostics powered by
machine learning
Why TFA?

4. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 4
Autonomous Usage
Oracle Grid Infrastructure
& Databases
Oracle Support
TFA
1
TFA detects a fault
2Diagnostics
are collected
3
Distributed diagnostics
are consolidated and
packaged
4
Notification of fault is sent
5 Diagnostic collection is
uploaded to Oracle
Support for root cause
analysis & resolution

5. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 5
On-Demand Usage
Oracle Grid Infrastructure
& Databases
Oracle Support
TFA
5
Upload diagnostic
collection to Oracle
Support
2
Real-time
status
summary
3
Diagnose
with DB
tools
4
Perform
diagnostic
collection
1 Request desired
action on-demand

6. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
6
2
3
4
5
6

7. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
7
2
3
4
5
6

8. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
REST service
• REST support allows invocation & query over HTTPS
• Oracle REST Data Services (ORDS) is included within the install
• Once ORDS is running REST invocations can be made via:
• Post to Result
• Can be downloaded with:
8
tfactl rest [-status|-start|-stop|-uninstall] [-dir ] [-port ] [-user ] [-debug [-level ]]
https://host:port/ords/api
https://myhost:9090/ords/tfactl/diagcollect {
"collectionId" : "20180111011121slc12ekf",
"zipName" : "TFA_DEF_ZIP_20180111011121",
"tagName" : "TFA_DEF_TAG_20180111011121"
}
https://myhost:9090/ords/tfactl/download/20180111011121slc12ekf
The tfactl rest command
can only be run by root
user
The standalone ORDS setup feature utilizes file based user authentication and is provided solely for use in test and development environments.
For production use, the included ords.war should be deployed and configured.

9. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
REST service
9
Option Description
-status Prints the current status
-start Starts Oracle Trace File Analyzer REST Services if not already running
-stop Stops Oracle Trace File Analayzer REST services if running
-uninstall Removes the Oracle Trace File Analyzer REST configuration
-dir
The directory to use to store the Oracle Trace File Analyzer REST configuration details.
Defaults to the users home directory
-port
The port to run ORDS on
Defaults to 9090
-user
The user to start ORDS as
Defaults to the GRID owner
-debug Enables debug
-level
The level of debug to use, where available levels are:
•1 - FATAL
•2 - ERROR
•3 - WARNING
•4 - INFO (Default)
•5 - DEBUG
•6 - TRACE

10. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
10
2
3
4
5
6

11. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Cluster Health Advisor Integration
• Problem events detected by Oracle Cluster Health Advisor (CHA) now
trigger the TFA diagnostic collection and email notification
– Email notification is configured via the standard process
– To set notification email for any problem detected:
– To set notification email for specific ORACLE_HOMEs include the OS owner:
11
tfactl set notificationAddress=john.doe@oracle.com
tfactl set notificationAddress=oracle:another.person@oracle.com

12. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
12
2
3
4
5
6

13. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
New SRDCs
13
Type of Problem SRDC
General ORA Errors
• ORA-01031
• ORA-01578
• ORA-08102
• ORA-08103
Problems showing alert log messages of "Corrupt block relative dba" • dbblockcorruption
ASM/DBFS/DNFS/ACFS problems • dbfs
Create/maintain partitioned/subpartitioned table/index problems • dbpartition
Alow create/alter/drop commands against partitioned table/index • dbpartitionperf
SQL performance problems • dbsqlperf
UNDO corruption problems • dbundocorruption
Exalogic full Exalogs data collection information • esexalogic
Listener errors : TNS-12516 / TNS-12518 / TNS-12519 / TNS-12520 • listener_services
Naming service errors: ORA-12154 / ORA-12514 / ORA-12528 • naming_services
Standard Information for Database Auditing • dbaudit
tfactl diagcollect –srdc srdc_name

14. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
14
2
3
4
5
6

15. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Use an External SMTP Service for Notifications
• TFA can send email notification when faults are
detected
– Configure SMTP with
– Check the current SMTP configuration
– Verify configuration by sending a test email with
• To set notification email for any problem detected:
• To set notification email for specific
ORACLE_HOMEs include the OS owner:
15
tfactl set notificationAddress=john.doe@oracle.com
tfactl set notificationAddress=oracle:another.person@oracle.com
tfactl set smtp
tfactl print smtp
tfactl sendmail {email_address}

16. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
16
2
3
4
5
6

17. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Metadata search capability
• All metadata stored in the TFA index is searchable using:
• Searching for all events for a database between certain dates can be done like this:
• Listing all index events can be done with:
• Listing all available datatypes can be done with :
17
tfactl search -showdatatypes|-json [json_details]
tfactl search -json
"{
"data_type":"event",
"content":"oracle",
"database":"rac11g",
"from":"01/20/2017 00:00:00",
"to":"12/20/2018 00:00:00"
}"
tfactl search -json "{"data_type":"event"}"
tfactl search -showdatatypes

18. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Program Agenda
REST service
Oracle Cluster Health Advisor detected event integration
New SRDCs
Use external SMTP server for notifications
Metadata search capability
ORAchk automatic start from install
1
18
2
3
4
5
6

19. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
Automatic Start From Install
• ORAchk will be automatically setup as part of TFA install
– Only on Linux or Solaris
– Only for root install
– Only on non-engineered systems
– Autostart will configure the daemon to restart at 1am every morning to rediscover any environment changes
– Full Local client run will be triggered at 2am every morning
– Most impactful checks will be run every 6 hours via the oratier1 profile
– Any collections older than 2 weeks will be automatically purged
• Once enabled daemon settings can be changed as per normal
• Remove with: ./orachk -autostop

20. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. |
For more info see
Document: 1513912.1
20

21. Copyright © 2018, Oracle and/or its affiliates. All rights reserved. | 21