[转帖]THE OSWATCHER ANALYZER USER'S GUIDE
|
oswbba THE OSWATCHER ANALYZER USER'S GUIDE Carl Davis To see how to use this tool and it's different features you can view a series of short "how to do" videos in document 301137.1 Contents
Introduction The OSWatcher Analyzer (oswbba) is a utility that allows the user to graph and analyze data collected from running OSWatcher. In addition to providing graphing and reporting capabilities, the analyzer will look for problems and provide recommendations on how to resolve them. Analyzing data automatically avoids the time consuming task of manually inspecting all the files that OSWatcher collects. NOTE: oswbba now analyzes ExaWatcher and CHM data. Analyzing these collections requires the use of a special flag -EXA for ExaWatcher and -CHM for CHM JSON files. Best PracticesPro-Active Problem Avoidance and Diagnostic CollectionAlthough some problems may be unforeseen, in many cases problems may be avoidable if signs are detected early enough. Additionally, if an issue does occur, it is no use collecting information about that issue after the event. oswbb is one of the tools that support recommends for collecting such diagnostics. For information on suggested uses, other proactive preparations and diagnostics see: Document 1482811.1 Best Practices: Proactively Avoiding Database and Query Performance Issues
Document 1477599.1 Best Practices Around Data Collection For Performance Issues Overview oswbba is a graphing and analysis utility which comes bundled with OSWatcher. This utility is a stand-alone java program which requires java to be installed. Because oswbba is written in java, the OSWatcher files that have been collected on Unix/Linux, can be analyzed on different Unix/Linux/Windows platforms that have java installed. Additionally, oswbba requires an x-windows environment in order to use all of its features. oswbba analyzes OSWatcher archive directroy files (vmstat, iostat, top, ps, netstat, traceroute, pidstat, meminfo and HP-UX sar) , Exawatcher and CHM files and automatically looks for problems and tries to determine root cause if possible. In addition to providing analysis, oswbba has an integrated dashboard which allows visibility into the different subsystems (cpu, memory, i/o, network and also nfs (Linux only). Problems can be quickly identified and displayed on the dashboard. The analysis text report is integrated with the browser dashboard so both textual data and graphics can be accessed inside the same browser window. See the OSW_Analyzer.pdf in the docs directory for more information. License oswbba use is under Oracle's standard licensing terms and does not require additional licenses for use. Supported Platforms oswbba is certified to run on the following platforms. It now runs on MacOS:
Installing oswbba oswbba is a Oracle support tool which requires no installation. It comes bundled with OSWatcher and is a standalone java jar file. Consult the README.txt for details about system requirements. Starting oswbba This newest version requires java 8.0 or higher. Before starting the oswbba utility you must have java 8.0 or higher installed on your system. Java can be downloaded for free from https://java.com. Also if you are running Oracle you already have a version of java installed. To verify you have the correct version of java installed on your system issue the following command...
If java is not installed, contact your system administrator to get the current version of java installed. Alternatively, you can use the version of java that comes shipped with Oracle. Here is an example of using the version of java that comes shipped with the database...(depending upon the version of the database, the jre may be in a different location)
Once the correct version of java has been verified, you can start oswbba. Please CD to the oswbb subdirectory where the oswbba.jar file is located. oswbba requires an input directory to run. To specify the input directory you must use the -i option. The input directory is the fully qualified path name of an archive directory location containing the oswbb logs. The archive directory must contain the respective subdirectories--oswvmstat, oswiostat, oswps, oswtop, oswnetstat, etc. If you are running Linux or HP-UX, then additional directories are also created. It is important to note the program requires an archive directory name not an individual log directory name or individual filename.
Java Heap Errors on Startup oswbba parses all the archive files in memory prior to generating graphs or performing an analysis. If you have a large amount of files to parse you may need to allocate more memory to the java heap. If you experience any error messages regarding out of memory such as java.lang.OutOfMemoryError, you may have to increase the size of the java heap. To increase the size of the java heap use the -Xmx flag.
Stopping oswbba To stop the oswbba utility select option "Q" from the menu. Using oswbba oswbba has multiple user interface options. If oswbba is started as above, the user will be able to choose from a list of options on a menu. In all cases oswbba must be supplied the archive directory location with the -i flag. If the underlying data from the OSWatcher archive is not available, such as the case where the data collector is missing or cannot run due to permission issues, then the option to analyze that data will be missing from the menu of options. Using oswbba: Menu Option oswbba can be run with a menu driven user interface. This option gives the user the most flexibility and allows graphs to be displayed real-time. To start oswbba with the menu option issue the following on the command line...
After starting oswbba, a set of options will display. Enter an option value and hit return.
Using oswbba: Command Line Option All graphing, dashboard generation and analysis options are available to be passed into oswbba from the command line. Only the -i option is required. Use the table below to add additional options.
Understanding the (-D) and (-A) options The (-D) and (-A) options specify a unique directory name under the oswbba/analysis directory where the analysis files get generated. Note this is a directory name and not a filename. This is a change from previous releases. If no directory name is specified then a default directory name will be generated. In this case make sure to place the (-D) or (-A) options at the end of the list of options. Note that the (-D) and (-A) options are mutually exclusive. Selecting the (-D) option will automatically trigger an analysis (-A) option. Therefore, it is not necessary to put a (-A) option alongside a (-D) option. Selecting the (-A) option however, will not trigger a (-D) dashboard. In both cases, the user specified directory name must be unique or the program will terminate with a warning. Analyzing Exawatcher Files oswbba can analyze ExaWatcher files in addition to OSWatcher files. The input is the ExaWatcher archive directory and the outputs are the same if you were analyzing OSWatcher. This provides for a consistent user experience across different data collectors. It is very important to make sure all the Exawatcher files are uncompressed and all the uncompressed files are removed before analyzing the archive. You must also use the -EXA flag for ExaWatcher so the analyzer knows the input is not the default OSWatcher files but Exawatcher files instead. More examples are in the OSW_Analyzer.pdf in the docs directory
Specifying the Begin/End Time of an Analysis (Recommended Method) Starting with release 7.0, the begin and end times could be specified to limit the analysis to a particular time of interest. This behavior changed in release 7.2. Begin and end times can be controlled by using the command line options -b and -e. These options are available if you run from the command line or can be chosen from the menu with the -s option. To use this option you must specify the begin time and the end time. If you specify either parameter without specifying the other parameter, or one or both of these times are not valid, the program will default to the following values. A warning will also be written to inform you that you have not specified valid inputs and default parameters will be used instead. Note: This is new behavior that differs from previous versions. If -b is specified and no -e is specified then program warns the input is invalid and uses the last end date available in the archive. If -e is specified and no -b is specified then program warns the input is invalid and uses the first begin date available in the archive. If -b is specified and is before the first available date in the archive then the program uses the first available date in the archive. If -e is specified and is after the last available date in the archive then the program uses the last available date in the archive. Example. In this example your archive contains 17 hours worth of data in the oswvmstat directory. You want to only analyze the time beginning Jan 9 13:15:00 2013 and ending Jan 19 13:30:00 2013
Limiting the Analysis to a Subset of Files in Your Archive (No longer supported as of version 9.0) Previously if a user wanted to analyze only a specific time window all of the files in the archive would have to be parsed first. Starting in release 6.0, the analysis can be limited to a subset of files. This can be controlled by using the command line options -START and -STOP. These options are available if you run from the command line or if you want to use the menu. In either case, you must use the -START and -STOP option along with the -s option (to tell the analyzer you want to analyze only a subset of available files. To use this option you must specify the starting filename in the oswvmstat directory. oswbba only analyzes files in chronological order. To specify the starting filename locate a filename in the oswvmstat directory and specify it using the -START option. The -STOP option specifies the last file in the oswvmstat directory that you want to analyze. If these filenames are misspelled or cannot be found the analyzer will ignore the -START and -STOP options and analyze the entire contents of the archive. If you specify either parameter without specifying the other parameter the following default values will be assumed: If -START is specified and no -STOP is specified then the analysis continues through the last file in the oswvmstat directory. If -STOP is specified and no -START is specified then the analysis starts at the oldest file in the oswvmstat directory and continues through the file specified in the -STOP option. You must also specify the -s option to tell the analyzer you want to analyze only a subset of available files. If the -s flag is NOT specified the analyzer will analyze the entire contents of the archive. oswbba uses the times associated with these oswvmstat files for the other directories so that all iostat, top and netstat files will be analyzed during this time frame. Example. In this example your archive contains 17 hours worth of data in the oswvmstat directory. You want to only analyze files starting at 13.01.09.1300 through 13.01.09.2000
Ignoring Specific Directories From Analysis Because the archive directory can contain gigabytes worth of data, the analyzer can take some time to analyze extremely large files. The analyzer parses these files and stores the data into memory structures that grow in size as more files are parsed. This parsing will consume more and more memory potentially causing the analysis to take a longer time and may cause the maximum size specified by the jvm to be reached. In this case you will need to restart using a larger value for jvm (see the section named "Java Heap Errors on Startup" located in this document. This is normally only a problem if you have many days worth of data or you have thousands of processes on the machine making for large ps files. If you find this to be the case you can eliminate certain directories from being analyzed. You cannot however, eliminate vmstat data because this data is critical to any analysis performed by oswbba. There also may be times when resources on the machine may not be available to allow this kind of heavier processing. By eliminating the oswps directory, this more intensive data parsing and analysis can be eliminated or postponed until a later time. To eliminate specific directories from the analysis you must specify the appropriate flag when running oswbba. Flags are as follows:
An example of ignoring netstat and iostat data from analysis:
Limiting the PS Analysis You can control the amount of analysis done on the ps data with respect to process memory. The default now is to show only the top 10 processes which are increasing in memory consumption. In the case you want to see all memory allocations over time you can do this by including the -MEM_ALL parameter when analyzing the data from the command line option. This would be useful for example in the case you were experiencing a memory leak. Enabling this parameter however, will result in long analysis times as the ps files are normally large and all the data related to all processes is parsed, stored and analyzed. There may be times when resources on the machine may not be available to allow this kind of heavier processing. By limiting the memory analysis, this more intensive data parsing and analysis can be eliminated or postponed until a later time. An example of analyzing all process information contained in the ps directory :
Limiting the Pidstat Analysis Analyzing pidstat data is very cpu intensive. For that reason, by default, pidstat analysis is limited to a maximum of 4 hours of data with the number of active processes being below 500. Unless both of these conditions are met the pidstat data will not be analyzed. To bypass this behavior, you can use the -YES_PIDSTAT flag. Using this flag will analyze all the pidstat files regardless of how many files or how many active processes are on the system. An example of forcing all pidstat files to be analyzed :
Generating a Dashboard Generating a responsive web page dashboard is a useful feature of oswbba. The dashboard allows for a view into the different subsystems (cpu, memory, i/o, network and also nfs (Linux only). Any problems can be quickly identified and displayed on the dashboard. The analysis based text report is integrated with the dashboard so both textual data and graphics can be accessed inside the same browser window.
An Example Dashboard Sample Charts https://mosemp.us.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=206049425975944&parent=DOCUMENT&sourceId=301137.1&id=461053.1&_afrWindowMode=0&_adf.ctrl-state=baoj3tz0s_167 Known Issues Because oswbba builds graphs based on the Unix operating system date function, the time stamp must be in Standard English LANG format. The time stamp is formatted automatically by default (setting the parameter oswgCompliance = 1) in the OSWatcher.sh file. REFERENCESNOTE:461054.1 - OSW System Profile - Sample |
![]() |
![]() ![]() ![]() ![]() ![]() ![]() ![]()
![]()
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

Didn't find what you are looking for?
Ask in Community...
|

OSWG_CpuSystem.gif
(42.39 KB)
OSWG_MemoryFree.gif
(22.18 KB)
r55y4
(273.32 KB)
|
|
- Oracle Database Products > Oracle Database Suite > Oracle Database > Oracle Database - Personal Edition > RDBMS > Database Level Performance Issues (not SQL Tuning)
- Oracle Database Products > Oracle Database Suite > Oracle Database > Oracle Database - Standard Edition > RDBMS > Database Level Performance Issues (not SQL Tuning)
- Middleware > Application Servers > Weblogic Server > Oracle WebLogic Server > WLS-Config (non-component)
- Oracle Cloud > Oracle Platform Cloud > Oracle Database Cloud Service > Oracle Database Cloud Schema Service
- Oracle Cloud > Oracle Infrastructure Cloud > Oracle Cloud at Customer > Gen 1 Exadata Cloud at Customer (Oracle Exadata Database Cloud Machine)
- Oracle Cloud > Oracle Platform Cloud > Oracle Database Cloud Exadata Service > Oracle Database Cloud Exadata Service
- Oracle Cloud > Oracle Platform Cloud > Oracle Database Cloud Service > Oracle Database Exadata Express Cloud Service
- Oracle Cloud > Oracle Platform Cloud > Oracle Database Cloud Service > Oracle Database Cloud Service
- Oracle Cloud > Oracle Platform Cloud > Oracle Database Backup Service > Oracle Database Backup Service
- Sun Microsystems > Specialized Systems > Middleware Systems > Exalogic Elastic Cloud X3-2 Hardware > SWITCH > CONFIGURATION
- Oracle Database Products > Oracle Database Suite > Oracle Database > Oracle Database - Enterprise Edition > RDBMS > Database Level Performance Issues (not SQL Tuning)
- Oracle Cloud > Oracle Platform Cloud > Oracle Cloud Infrastructure - Database Service > Oracle Cloud Infrastructure - Database Service
|
[转帖]THE OSWATCHER ANALYZER USER'S GUIDE的更多相关文章
- Linux监控工具介绍系列——OSWatcher Black Box
OSWatcher Balck Box简介 OSWatcher Black Box (oswbb)是Oracle开发.提供的一个小巧,但是实用.强大的系统工具,它可以用来抓取操作系统的性能指标,用 ...
- OSWatcher Black Box
Linux监控工具介绍系列--OSWatcher Black Box OSWatcher Balck Box简介 OSWatcher Black Box (oswbb)是Oracle开发.提供的一个小 ...
- 安装使用Oracle OSWbb/OSWbba工具
OSWbb是收集数据,OSWbba 是分析数据,在OSWbb4.0以后,OSWbba已经绑定在OSWbb内. 1.创建目录,上传/解压安装包 [oracle@std ~]$ mkdir oswbb [ ...
- oracle_hc.sql
select event,count(1) from gv$session group by event order by 2;exec dbms_workload_repository.create ...
- 如何在 arm 官网上找到合适的手册
http://infocenter.arm.com/help/advanced/help.jsp 在这里输入合适的版号即可 这样就可以不用去 CSDN 了 100000_0000_00_EN - AR ...
- 竞态条件 race condition data race
竞态条件 race condition Race condition - Wikipedia https://en.wikipedia.org/wiki/Race_condition A race c ...
- [转帖]Programmer’s guide to the big tech companies 💻
Programmer’s guide to the big tech companies
- [转帖]Intro Guide to Dockerfile Best Practices
Intro Guide to Dockerfile Best Practices By Tibor Vass July 02 2019 https://blog.docker.com/2019/ ...
- MAT(Memory Analyzer Tool)工具入门介绍(转)
1.MAT是什么? MAT(Memory Analyzer Tool),一个基于Eclipse的内存分析工具,是一个快速.功能丰富的JAVA heap分析工具,它可以帮助我们查找内存泄漏和减少内存消耗 ...
- P6 EPPM Manual Installation Guide (Oracle Database)
P6 EPPM Manual Installation Guide (Oracle Database) P6 EPPM Manual Installation Guide (Oracle Databa ...
随机推荐
- C#数据结构与算法系列(十七):时间复杂度(下)
1.常见的时间复杂度 常数阶:O(1) 对数阶:O(log2n) 线性阶:O(n) 线性对数阶:O(nlog2n) 平方阶:O(n^2) 立方阶:O(n^3) k次方阶:O(2^n) 常见的算法时间复 ...
- 伯克利:serverless是下一代计算范式
摘要:Serverless技术正是云厂商的基于规模经济的一个选择. 引子 刚过去的HC2020,华为面向多样化算力的时代,发布了DC分布式计算的三个开发套件,其中一个是元戎组件.元戎是基于函数计算的分 ...
- 云小课 | 一个三分钟快速定制OCR应用的神器,要不?
摘要:ModelArts Pro提供了文字识别套件,基于丰富的文字识别算法和行业知识积累,帮助客户快速构建满足不同业务场景需求的文字识别服务.三分钟即可快速定制OCR服务,实现多种版式图像的文字信息结 ...
- vue2升级vue3:vue3创建全局属性和方法
vue2.x挂载全局是使用Vue.prototype.$xxxx=xxx的形式来挂载,然后通过this.$xxx来获取挂载到全局的变量或者方法 在vue3.x这种方法显然是不行了,vue3中在setu ...
- iOS 应用上架的步骤和工具简介
编辑 APP开发助手是一款能够辅助iOS APP上架到App Store的工具,它解决了iOS APP上架流程繁琐且耗时的问题,帮助跨平台APP开发者顺利将应用上架到苹果应用商店.最重要的是,即使没有 ...
- 9月活动回顾(免费领取PPT)|火山引擎DataLeap、ByteHouse多位专家带来DataOps、实时计算等前沿技术分享!
更多技术交流.求职机会,欢迎关注字节跳动数据平台微信公众号,回复[1]进入官方交流群 在上月举行的火山引擎开发者社区 Meetup 第12期暨超话数据专场<数智化转型背景下的火山引擎大数据技 ...
- Word 文档怎么保留修改前和修改后的内容--审阅 修订
如果启用了修订内容后,对文档的内容进行了相关的修改后.则文档可以同时显示被修改的内容和修改后的内容.下面,本文通过举例具体介绍如何使用修订功能. 点击选中文档内容,然后依次点击[审阅]-[修订]-[修 ...
- 创建一个简单的Docker镜像
1. 创建 Dockerfile 文件.index.html测试页面 [root@localhost docker]# vi Dockerfile FROM nginx:1.17.6 #基于 ngin ...
- 用 three.js 绘制三维带箭头线 (线内箭头)
在LineMaterial.js基础上修改的ArrowLineMaterial.js代码: /** * @author WestLangley / http://github.com/WestLang ...
- OpenTSDB 数据存储详解
本文首发于 vivo互联网技术 微信公众号链接: https://mp.weixin.qq.com/s/qayKiwk5QAIWI7-nyD3FVA作者:DuZhimin 随着互联网.尤其是物联网的发 ...


