Foglight for Oracle monitors the Oracle database activity by connecting to and querying the Oracle database. The agents provided monitor the Oracle database system. The dashboards included with the cartridge provide a visual representation of the status of the major components of the Oracle agents. They allow you to determine any potential bottleneck in database performance. This section provides agent configuration instructions and information on investigating Oracle database performance. It covers the entire monitoring process, starting with the discovery of the database instances and the connection with these instances, and proceeding with the use of the various drilldowns and the Global Administration options.
This section covers the following key areas:
This section describes the various components of the Databases dashboard. For more information, refer to Viewing Databases Dashboard.
Use the Databases area of the navigation pane to create, edit, and remove groups of database instances. Click Edit Group to add or remove database instances from the sub-group.
To create a database group:
The Add Group dialog box displays the name of the parent group in the Parent field. Before proceeding, ensure that the sub-group is added to the requested group.
To add sub-groups to a selected group:
To remove a database group:
To edit a database sub-group:
The Customizer button of the table and the In-context action buttons are common to all Foglight for Oracle screens. The Customizer button — use this button, which is found on the upper right corner of each table, to create a custom filter for the table. The filter is created by clicking Customizer and specifying the criteria that the various values should meet in order to be displayed in the table (having a specific name, exceeding a certain size, and so on).
In-context actions buttons — found on the upper right corner of all screens:
The currently selected database group table displays the following columns.
Name | Description |
---|---|
Instance | |
Sev | The highest severity alarm of the Oracle database (whether a database instance, RAC or RAC node), which determines the database’s health state |
Name | The name of the Oracle instance, RAC or RAC node. In addition, this row includes the Go to Home Page button. |
Version | The version number of the Oracle database instance. |
Up Since | The date and time that the Oracle database instance (or, in a RAC, the instance that was the earliest to restart) was last restarted. |
Workload | The workload (average active sessions) for the Oracle database instance or RAC. When holding the cursor over the workload graph, the dwell displays a chart that shows the workload history over the specified time range. |
DB Alarms | The number of warning, critical, and fatal alarms for the Oracle database instance/RAC. When holding the cursor over one of the alarm counts, the dwell displays the most recent alarms invoked for this database, sorted by severity. Clicking this field displays the Alarms list, which is listed by severity order. See the Foglight Online Help, Monitoring System-Wide Alarms for details on the alarm information |
System Utilization | |
Host | The name of the computer that is hosting the database instance or RAC. |
CPU Load (%) | The overall operating system CPU usage by all processes (including CPU usage by the database). |
Memory (%) | The percentage, within the total memory, of memory consumed by all operating system processes (including the database). This value includes both RAM resident memory and swapped memory. |
Disk (% Busy) | The percentage of time the busiest device spent serving system-wide input/output requests. This metric serves as a measure for the system I/O load. |
Monitoring Status | |
Agent | The operational status of the monitoring agent. When the agent instance is running, the State icon is green, and holding the cursor over the icon displays the message Collecting Data. When the agent instance is running but not collecting data, holding the cursor over the icon displays one of the following status messages listed below. - Starting Stopped Stopping Unknown When SQL PI is configured the SQL PI icon is displayed. |
OS | The status of the OS data retrieval. Note: While the Foglight for Oracle agent retrieves OS data, several OS metrics cannot be retrieved without the Infrastructure cartridge agent. IF OS monitoring was disabled during the creation of the Foglight for Oracle agent through the Oracle Monitoring Installer wizard, the wizard cannot automatically create the Infrastructure cartridge agent; However, this agent can be created manually using the Dashboards > Hosts > Hosts dashboard. Note: If the Infrastructure agent was created, but OS database is collected only by the Foglight for Oracle agent, click the OS status to OS data collection through the Infrastructure agent. |
The Foglight for Oracle Overview dashboard provides various detailed views that are accessible using the toolbar. The Overview dashboard contents depends on whether a RAC (Real Application Cluster) or an Oracle database instance is selected.
Several charts can display information in either of the following formats:
The Foglight for Oracle Overview dashboard provides the following toolbar buttons.
Name | Description |
---|---|
Overview | Opens the Overview view. |
Advisories | Opens the Advisories view. |
SQL PI | Opens the SQL Performance Investigator (SQL PI) drilldown, which displays performance-related data at the following levels: High-level data — available for all instances. In-depth data, delivered by means of the Cluster view or Instance view tree — available only for instances or RACs that have Performance Analysis installed and configured. |
Activity | Opens the Reviewing Instance Usability, which contains the following panels: Real-Time — refer to Viewing the Foglight for Oracle Real-time Summary. Usability — refer to Reviewing Instance Usability and Reviewing Cluster Usability. Locks — refer to Reviewing Locks Activity at the Cluster Level and Reviewing Locks Activity at the Instance Level. Sessions — refer to Viewing Detailed Sessions Data. Overall Datafiles I/O — refer to Viewing Datafiles I/O Activity at the Cluster Level and Viewing Datafiles I/O Activity at the Instance Level. User-defined Collections — refer to Viewing User-Defined Collections |
Pluggable Databases | Oracle pluggable database only — Opens the Pluggable Databases Drilldown, which contains the following components: Pluggable Databases List table — refer to Pluggable Databases List table. Overview tab — refer to Overview tab. Activity within Instance — shows the selected pluggable databases’ activity as part of the entire instance activity. For details, refer to Activity within Instance/Cluster tab |
Storage | Opens the Storage Drilldown, which contains the following panels: Tablespaces and Datafiles — refer to Tablespaces and Datafiles Panel. Redo Logs — refer to Redo Logs Panel. Archive Logs — refer to Archive Logs Panel. Invalid Objects — refer to Invalid Objects Panel. Database Backup — refer to Database Backup Panel. The Storage panels are common for both RAC and all of the instances |
Configuration | Opens the Configuration drilldown, which contains the panels listed below. GA — refer to Reviewing SGA Settings at the RAC Level Initialization Parameters — refer to Reviewing the Initialization Parameters. |
Alert Log | Opens the Alerts drilldown, which contains the following panels: Error Log — refer to Reviewing the Alert Log. Alert log — refer to Reviewing the Alert Log |
The upper section of the view includes general information on the monitored database:
The tiles are organized by priority:
The right panel is used to display either alarms or Top 10 SQLs:
Only the three resources would directly be displayed, according to the importance. The state of backup’s alarms is also displayed.
The Advisories view is provided to continually analyze application performance to identify performance inefficiencies, to guide you through problem resolution strategies, and to deliver a step-by-step action plan for maximizing database performance. The upper section of the Advisories view includes general information on the monitored instance:
The lower section of the Advisories view contains the following two elements:
Advisories are listed in the order of their priority that considers the severity of the detected deviation and the type of advisory.
Refer to the table below for the Lists of advisories and short descriptions of their purpose:
Advisory Name | Description |
---|---|
Instance Total Memory | Helps to indicate when a defined total memory size is not optimal and provides recommendations on how to tune it. |
SGA Size | Helps to indicate when a defined SGA size is not optimal and provides recommendations on how to tune it. |
PGA Size | Helps to indicate when a defined PGA size is not optimal and provides recommendations on how to tune it. |
Unbalanced Cluster Workload Distribution |
Indicates when a workload is not distributed equally across all nodes and provides more details for further investigation. |
Undo Size | Helps to indicate that undo size should be tuned and provides some recommendations on how to do it. |
Bind Variables Candidates | Helps to indicate a high percentage of hard parsing and find potential SQL statements for using bind variables. |
Oracle Workload Deviation | Indicates when the overall workload consumption exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
CPU Usage Deviation | Indicates when the total instance CPU usage exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
User I/O Usage Deviation | Indicates when the total instance wait for user I/O usage exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Network Wait Deviation | Indicates when the total instance wait for network exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Commit Wait Deviation | Indicates when the total instance wait for commit exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Concurrency Wait Deviation | Indicates when the total instance wait for concurrency exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Application Wait Deviation | Indicates when the total instance wait for application exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Other Wait Deviation | Indicates when the total instance categorized as “Other” wait for application exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
Cluster Wait Deviation | Indicates when the overall cluster wait consumption exceeded the baseline. Deviations outside the baseline range suggest abnormal or unexpected activity and should be investigated to determine whether they suggest a performance problem. |
The SQL PI view provides the ability to investigate the activity and resource consumption of a selected instance. There are two levels of metrics available:
The performance tree provides iterative (up to three levels) access to any of the key dimensions associated with Oracle Database activity, based on the OLAP multidimensional model and an database view of the database activity. Domain nodes offer a hierarchical view of all types of Oracle Database activity characteristics. Selecting a dimension from the tree determines what subset of activity is displayed. Iterative drill-down into domains of interest provides increasingly refined focus and diagnosis.
For example, to begin the investigation by first identifying the most active User, follow the steps described below:
The default Oracle dimensions are as follows:
The History section view is divided into two sections that are correlated to each other:
Selecting each dimension in the performance tree together with a specific resource effects the data displayed for each Level.
The Lock Analysis displays all locks that took place within the selected time range. The lock analysis feature is integrated as part of the performance tree and it displays all the lock trees including further details for both the blocker and the blocked session including:
The Activity Highlights are provided for fast performance analysis and allow users focus on the most significant dimensions that are relevant for the resource selected in the selected time range.
This pane comprises the following elements:
The change tracking tool is an integrated monitoring mechanism. It periodically tracks changes in environments and activity that can potentially influence system performance and enables the user to view correlation between occurrences of changes and Oracle’s activity and behavior patterns. Use the Categories filter mechanism to refine the set of displayed change tracking occurrences. These categories are displayed on the right hand side of the pane and include:
This view presents the execution plan of a selected SQL and the cost of it. A Historical execution plan can be generated and will present any two views of the execution plan. There are two ways to access the Execution Plan History dialog:
Top Bar
Plan analysis section
The execution plan contains 3 tabs:
By clicking the Generate Plan button the execution plan is generated and can be viewed. By clicking on the Compare Plan button a pop up will appear that allows comparing all available execution plans of the selected SQL statement.
Use the SQL PI Compare where differences in period activity illustrate underlying performance and monitoring issues. It helps you determine whether a comparison occurrence is an isolated incident or a sign of a potentially significant performance problem. Compare can be accessed from the Performance tree. The comparison can be of whole instances or selected dimension breakdowns (such as user or SQL). Use Compare to address questions such as:
The upper panes graphically displays the Workload or any other selected resource. The middle Activity section displays the dimensions which were significant elements of the difference. Expanding the individual lines displays the dimension members which caused the difference and the composing metrics whose differences exceed the specified threshold. Use the set of performance related metrics (defined by the chosen resource) to help you explain the difference in resource consumption; for example, a rise in I/O Wait might be explained by a rise in the quantity of physical reads. Use the Comparison Parameters section in order to enter all the desired information for the cooperation. For example, time range, instance, dimension, time frames, resource.
Use the Oracle Activity drilldown to carry out the operations described in the following topics:
The following image displays the main elements of the Foglight for Oracle real-time summary page. The table that follows the image identifies each element, and provides a link to display more information, corresponding to the logical dataflow within Foglight for Oracle Instance Homepage. The main groups (panes) of gathered icons and gauges, which represent the main activity areas in the Oracle connection process, are as follows:
Use the Instance identification indicators to identify the instance, its type and its operation period. These indicators are:
The initial view of the pane only shows the date; to display the time as well, hover the mouse or click the date text.
The initial view of the pane only shows the OS name; to display the build and service packs as well, hover the mouse or click the OS name.
The indicators included in the Instance pane provide various details about the instance. All of the indicators display real-time behavior, color-coded for severity.
Clicking the Response Time, CPU (%) and Memory (%) indicators displays a popup that shows the value of the metric, plotted over time.
The Sessions pane monitors all session types, that is: system, user, and Oracle sessions. Use this pane to view the response time compared with the number of sessions and the instance’s level of activity. A high response time value may result from a long queue, that is: an overly high percentage of active users. Long queues can indicate one of the following issues:
The Sessions pane displays the total number of sessions, distributed according to the following distinctions:
Flow | Description |
---|---|
Executions | The rate per second of calls (both user and recursive) that executed SQL statements. |
Received packets | The rate at which network packets are being received by Oracle from Client applications. When this color is yellow, clicking it displays text that describes the deviations that triggered this display, along with a representation of the rate at which Oracle is encountering network packet errors. |
Sent packets | The rate at which network packets are being sent from Oracle to Client applications. When this icon’s color is yellow, clicking it displays text that describes the deviations that triggered this display, along with a representation of the rate at which Oracle is encountering network packet errors. |
Use the Data Guard section for monitoring Oracle Data Guard on primary databases. This section displays the gap between the last archive log on the primary database and last applied archive log on the standby database. Oracle Data Guard can be configured as either physical or logical standby. For details about the preparations required for monitoring each of these setups, refer to Monitoring the Data Guard physical standby and Working with logical standby (SQL Apply). As Oracle Data Guard supports physical standby databases that use Redo Apply technology, use this section to monitor the rate of applying redo log files on standby database instance.
The Data Guard section displays data only if the Data Guard service is configured.
Starting from Oracle 11g, Oracle provides the Active Data Guard option, which allows the standby to be read-only mode and at the same time to receive changes received from the primary node.
To prepare the physical standby:
Switching to read-only is only for the standby user availability check; there is no need to stay in that mode after the checkup.
To prepare the logical standby:
The Workload chart displays the workload of the average active sessions, plotted over time. The workload can be plotted as either:
The Process Activity pane enables the monitoring of the processes ran by the Oracle instance, using performance indicators such as the total number of blocked processes and the rate per second of parses that are carried out during the most recent sample. The Process Activity pane displays the following parameters.
Parameter | Description |
---|---|
Recent Executions | The number of statements executed during the most recent sample. |
Blocked Processes | The average number of blocked processes that were collected during the specified time range. Blocked processes are processes that are waiting for another process to release a resource that the process is currently locking. Such processes can sometimes result in bottlenecks. The Blocked Process indicator changes its color when one or more processes become blocked. |
Parses | Total number of parse calls. This figure is the total of both hard parse calls (calls that require loading the SQL source code into RAM for parsing) and soft parse calls. |
Concurrent Transactions | The number of currently running transactions. |
To communicate with the Oracle memory, the Oracle processes use logical reads and soft and hard parses, represented as flows in the homepage.
The Memory Activity session provides a view on the memory utilization of an Oracle instance, as described in the following table.
Section | Metric | Description |
---|---|---|
SGA | Total (MB) Buffer Cache (MB) Shared Pool (MB) Buffer Cache Hit (%) |
The actual size currently allocated to the System Global Area (SGA) memory. The amount of memory currently allocated to the buffer cache. The buffer cache, which is used for caching frequently accessed data blocks, is normally the largest memory cache used by Oracle. The size of the shared pool. The shared pool caches SQL statements, PL/SQL programs, object definitions, and session memory for MTS sessions. Performance can improve when the shared pool is sized properly, thereby avoiding re-parsing and reloading. The percentage of block requests, which found the block in the buffer cache, out of the entire block requests (including requests that required disk reads). |
Library Cache Hit (%) | The effectiveness of the library cache, computed by comparing the number of queries submitted to Oracle server for execution, which found the parsed execution plan in the library cache (soft parsing), with the entire number of queries submitted during the specified time range (including queries that required the parsing of a new statement, also known as “hard parsing”). | |
PGA | Total (MB) PGA Hit (%) |
The actual size currently allocated to the Program Global Area (PGA) memory The percentage PGA cache hit ratio. When the value of this metric is 100%, it indicates that all work areas executed by the system processed the entire input data using exclusively the PGA memory, thereby making optimal use of this memory. Any lower value indicates that at least one work area required one or more extra passes over the input data. |
The Storage pane contains the components listed below, which display storage status. The information shown in this pane is aggregated to the RAC level.
Datafiles-related Indicators
Archive Destinations-related Indicators
If archiving is configured, the following indicators display storage-related information about the most critical archive destination, that is: the archive destination with shortest time to failure. This section contains the following indicators:
Indicators of Storage-related ASM Information If storage is managed using Automatic Storage Management (ASM), and the ASM instance is installed and configured, the following indicators display storage-related information about ASM:
Monitoring Disk Activity
The Disk Activity section displays the following indicators:
Tracking Physical I/O Activity The real-time summary page contains flows and graphic images that are used for tracking physical I/O activity, as listed below. All of the indicators display real-time behavior, color-coded for severity. Clicking each indicator displays a popup, which shows the metric’s value, plotted over time.
The Instance Usability panel displays aggregated information regarding the instance’s usability and availability. This panel supports the following tasks:
The Instance pane contains the following indicators:
The Alarms pane displays the usability-related outstanding alarms. These alarms alert the following issues per instance: response time, instance availability, instance connection availability, OS connection availability, instance connection time, and Listener status.
The Instance Availability section displays the instance availability in percentages, plotted over the time range. If the instance was unavailable once or more during this time, the relevant message describing the last occurrence of unavailability appears in the Error Message box.
The Listener Availability section displays the availability of all listeners configured for the instance, in percentages, plotted over the time range. If one or more of the listeners were unavailable during this time, a message describing this issue appears under the Listener Errors section.
The Connection Time section displays the instance’s connection time, in seconds, plotted over the time range.
The Response Time section displays the instance’s response time, in milliseconds, plotted over the time range.
Use the Cluster Usability panel to compare between the various RAC nodes, regarding the following indicators:
The Availability section also displays the listener’s availability during the specified time range.
To investigate a single instance, select the requested instance from the list at the top of the panel. The display switches to instance usability.
The Activity Locks panel for a RAC comprises the following panes:
The Locks Activity pane displays a breakdown of all lock types and their general properties.
Name | Description |
---|---|
Lock Name | The name of the lock. |
Gets | The total number of enqueue requests or enqueue conversions for this type of enqueue. |
Gets Rate | The rate of lock gets. |
Gets (percent) | The percentage of lock gets for this type of lock within the total number of locks |
Enqueue Waits | The total number of times an enqueue request or conversion resulted in a wait event. |
Waits Rate | The number of wait events per second. |
Wait (percent) | The percentage of wait events for this type of lock within the total number of locks |
Lock Wait | The total amount of time spent waiting for the enqueue or enqueue conversion. |
Average Lock Duration | The average length of time for a lock, in milliseconds. |
Lock Efficiency | The percentage of lock requests that did not escalate to a blocking lock. |
Alarms | The number of warning, critical, and fatal alarms that were invoked for this Oracle database instance. Holding the cursor over each alarm type displays a dwell that shows the most recent alarms invoked for this database instance, sorted by severity. Click each alarm type to drill down and manage the alarms. |
The Lock Tree (Current) pane displays current data, which is available only in real-time mode. Clicking any locking or locked session table row displays a popup that is used for viewing further details.
Name | Description |
---|---|
PDB | In multitenant architectures, the name of the pluggable database where the lock took place. |
Session | The identifier for a session that holds or acquires the lock. |
Serial | The session’s serial number. The combination of SID and serial number provides a unique identification of the session. |
DB User | The database user name. |
Object Wanted | The object requested for lock. |
Lock Type | The type of user or system lock. The locks on the user types are obtained by user applications. Any process that is blocking others is likely to be holding one of these locks. The user type locks are: TM — DML enqueue TX — Transaction enqueue UL — User supplied |
Lock Mode | The lock mode in which the session holds the lock. This row can have one of the following values: None Null Row-S (SS) Row-X (SX) Share S/Row-X (SSX) Exclusive |
Lock Request Mode | The lock mode in which the process requests the lock. This row can have one of the values listed below. None Null Row-S (SS) Row-X (SX) Share S/Row-X (SSX) Exclusive |
Lock Duration | The duration of the lock in seconds. |
Cross Instance | Defines whether the lock is between different cluster nodes: YES — for global locks NO — for single node locks |
Instance | The name of the instance to which the blocking or blocked session belongs. |
Kill Session | Used for terminating the selected session, by means of the Kill Session dialog box that is displayed upon clicking this column. Note: Killing a session requires having specific privileges. Provide an Oracle user with these privileges. Alternatively, select the check box Log-in as SYSDBA to provide the credentials of a SYSDBA user. |
Session Details Popup
Name | Description |
---|---|
SID | The session identifier |
Session | The identifier for a session that holds or acquires the lock. |
Serial | The session’s serial number. The combination of SID and serial number provides a unique identification of the session. |
DB User | The database user name. |
OS | The operating system name |
Program | The name of the program that is processing the SQL statements |
Client | The Client computer identifier |
Host | The host computer identifier |
Current SQL | The SQL text of the SQL statement that is currently being processed in this session |
Locks Historical Tree
The Locks Historical Tree pane displays the overall locks activity that took place within the selected time range, as well as locks that exceeded a predefined threshold. This pane comprises the following sections:
The minimal duration’s length is defined using the Locks pane of the Collection Settings view.
The Activity Locks panel, which displays lock summary information for an Oracle instance, comprises the following panes:
The Locks Historical Tree pane displays the locks activity and the locks tree summary, plotted over time. This pane includes the sections listed below. Locks Activity — this section, which is identical to the Locks Activity section in the Locks Overview pane, displays the lock wait (average active sessions), which can be plotted as either:
The Sessions screen allows you to trace the activity of all currently connected sessions, as well as their resource consumption.
The refresh rate of the data displayed on the Sessions panel can be set by selecting a value from the Refresh interval drop-down list, which appears on the panel’s upper right side.
The Current section in the top of the screen allows you to view current Key Performance Indicators of the monitored instance:
The Last 1 hour trend presents the activity on the instance during the last 1 Hour by presenting:
By clicking the Top Wait Events link at the upper right corner of the section, The Active Wait Events popup appears, with the Resource drop-down list unfiltered and displaying the entire list of wait events.
The current sessions table allows you to monitor the currently running sessions and their individual resource consumption. The Session List section contains a table that lists all currently running sessions, displaying each session in a separate row. The Sessions view in the table can be filtered by the Active only and Foreground Only check boxes:
The various sections of the Session Drill Down page provide detailed information about the selected session upon selecting a specific session in the table.
Session Details Section
The left section of the screen displays several parameters that provide general information about the selected session, as follows:
Clicking on the Session ID enables you to switch sessions from a popup list of current sessions.
Reviewing Workload Details
The Workload chart displays the selected session workload (Average Active Sessions) during the specified time range (default 1 hour). The breakdown displays the workload, distributed by the various wait event categories. The colors of the categories match the colors of the various resources displayed in the Resource Breakdown section. By clicking the Top Wait Events link at the upper right corner of the section, The Active Wait Events popup appears, with the Resource drop-down list unfiltered and displaying the entire list of wait events.
Reviewing SQL Summary
This tab provides details about the SQL statements that were executed by the selected session during the selected time range (up to 1 hour).
Reviewing Sessions Statistics
Additional statistics are displayed in the Session Statistics tab.
Reviewing Session Blocks
The Session Blocks pane displays all blocks held or requested by the selected session.
The Overall Datafiles I/O panel displays the I/O activity of all datafiles on the cluster. This panel includes the following sections:
The Physical I/O chart displays the physical I/O activity within the cluster’s datafiles, in either of the following methods:
Baseline and Breakdown are not available at the cluster level.
The Datafiles I/O Summary table displays all of the I/O activity details of all datafiles on the cluster. Clicking the datafile’s name displays the Physical I/O Activity page, which presents the datafile’s physical read and writes, plotted over the time range, along with the overall physical reads and writes.
To view the specific datafile’s storage data, click the link Datafile Storage, on the upper right side of the Physical I/O Activity page.
The Overall Datafiles I/O Activity panel displays the I/O activity of all datafiles on the instance. This panel includes the following sections:
The Total physical I/O chart provides a graphic representation of the physical I/O activity within the instance’s datafiles. This representation is displayed in either of the following methods:
The Datafiles I/O Summary table displays all of the I/O activity details of all datafiles on the instance. Clicking the datafile’s name displays the Physical I/O Activity page, which presents the datafile’s physical read and writes, plotted over the selected time range, along with the instance physical reads and writes. In multi-tenant architectures, the PDB column identifies the pluggable databases that use the datafiles.
To view the specific datafile’s storage data, click the link Datafile Storage, on the upper right side of the Physical I/O Activity page.
Use the User-defined Collections panel to see customized collections, which were created using the User-defined Collections view in the Databases Administration dashboard, either during the most recent sample (Last Sample) or plotted over the specified time range (Selected Period). This panel comprises the following sections:
The Pluggable Databases drilldown contains the Pluggable Databases pane, which displays a table of all pluggable databases (PDB), as well as the container databases (CDB), which are monitored in the instance. Selecting a row in the table displays the details of the selected container in the following panes:
The Pluggable Databases List table includes the following columns:
The Overview tab contains the following sections, which display general information about the pluggable database selected in the Pluggable Databases List table:
The Activity within Instance tab contains the following sections, which display information about the pluggable database selected in the Pluggable Databases List table:
The Storage drilldown comprises the panels described in the following topics:
The Tablespaces and Datafiles panel comprises the sections described in the following topics:
For details, refer to Datafile-specific Page.
The Tablespaces page displays the database individual tablespace information, sorted by either percent of space usage or size.
By default, all types of tablespaces are monitored.
Top 10 Tablespaces Chart
The Top 10 Tablespaces bar chart displays the tablespaces that have the highest used value, sorted by:
Name | Description |
---|---|
Show top | Use the Show top options to select which metric the vertical axis displays for the top 10 tablespaces: Size — size in megabytes. % Space Usage — percent. |
Percent (chart vertical axis) | The percentage of the database tablespace pages currently being utilized. |
Megabytes (chart vertical axis) | The database tablespace utilized size in megabytes. |
Tablespaces (chart horizontal axis) | The names of the top 10 most utilized tablespaces. |
Tablespace bar | The bar chart representation of the utilized tablespaces. Click a specific tablespace representation to drill down further to the Tablespace-specific page. |
Tablespaces Summary Table
The Tablespaces Summary table shows the status for all of the database tablespaces. To view details on a specific tablespace, click the tablespace.
Name | Description |
---|---|
PDB | In multitenant architectures, identifies the pluggable database that uses the tablespace shown in the Tablespace column. |
Tablespace | The name of the tablespace. Click the tablespace name to drill down further to the Tablespace-specific page. |
Total Size | The total amount of allocated space (in megabytes) in this tablespace. |
% Space Usage | The percentage of used allocated space in this tablespace. |
Contents | The type of tablespaces content: PERMANENT TEMPORARY UNDO |
Number of Datafiles | The number of datafiles in the selected tablespace. To view a list of all datafiles of which the tablespace consists, and possibly drill-down to a datafile-specific page, click the tablespace name to access the Tablespace Details > Datafiles pane. |
Estimated Until Full | Estimated number of days until tablespace is full. If the tablespace used space did not grow during the selected period, this field shows the indication no growth. |
Autoextensible Datafiles | The sum of the Autoextensible OS Datafiles and Autoextensible ASM Datafiles metrics. |
Alarms | The number of warning, critical, and fatal alarms for this Oracle database tablespace. |
The Datafiles grid displays a list, sorted by usage, of all datafiles used by the database.
Name | Description |
---|---|
PDB | In multitenant architectures, identifies the pluggable database that uses the datafile shown in the File Name column. |
File Name | The file name of the datafile, including the full directory path. Click the file name to drill down further to the Datafile-specific panel. |
Tablespace | The name of the tablespace that contains the selected datafile |
Size | The current size of the datafile in megabytes. |
Use | The current used megabytes associated to the datafile, as a percentage of datafile’s allocated size. |
Autoextend | Indicates whether the datafile is auto-extensible. |
The Tablespace-specific page charts used and free space, as well as the fragmentation level of the tablespace (to determine how much space can yet be utilized). The datafiles that make up the individual tablespace appear on the bottom pane of the dashboard. This page comprises the following sections:
The tablespace properties are provided using the following panes:
Tablespace Properties Alarms
Name | Description |
---|---|
Alarms | The number of warning, critical, and fatal alarms for the selected tablespace. |
Tablespace Properties Table
Name | Description |
---|---|
Status | Indicates the current status of the tablespace — Online or Offline. |
PDB | In multitenant architectures, shows the pluggable database that was listed beside the selected tablespace in the Tablespaces Summary table. |
Extent Management | Indicates the method used for managing extents in this tablespace: DICTIONARY — within the Oracle data dictionary LOCAL — within the tablespace itself |
Allocation Type | The type of extent allocation to be used for this tablespace. USER — allocates extents as per the storage clause provided with the object or defaulted at tablespace level. UNIFORM — allocates the uniform sizes for the extents. SYSTEM — automatically allocates system-generated extent sizes. |
Force Logging | Indicates if the tablespace is in Force Logging mode, which logs all changes to all objects in the tablespace, except changes to temporary segments. The possible values are Yes and No |
Logging | Indicates if a redo log is to be generated for the tablespace. The possible values are Logging and No. |
Segment Space Management | Indicates how free and used segments are managed. MANUAL — using free lists AUTOMATIC — using bitmaps |
Default Table Compression | Indicates the status of default table compression; either Enabled or Disabled. |
Retention | Indicates if unexpired undo blocks are retained in the tablespace. NOT APPLY — used for tablespaces other than the undo tablespace. GUARANTEE — applies only to undo tablespaces. NOGUARANTEE — applies only to undo tablespaces |
Big File | Indicates if the tablespace is a BIGFILE tablespace (Yes) or a small file tablespace (No). BIGFILE tablespaces are supported only for locally managed tablespaces with automatic segment-space management. |
Block Size | The size of the memory block used by this tablespace in megabytes. |
Encrypted | Indicates whether the tablespace data is encrypted (Yes) or not (No). |
Name | Description |
---|---|
Total | Total amount of available memory for this tablespace, plotted over time. |
Used | Amount of available memory that is used for this tablespace, plotted over time. |
The tablespace details are provided using the following panes:
Datafiles Table
Name | Description |
---|---|
Datafile name | The datafile name, including the full directory path. Click the datafile name to drill down further to the Datafile-specific panel. |
Size | The current size of the datafile in megabytes. |
Filesystem Free | Available space on the file system as a percentage of file system size, rounded up to one decimal. If the filesystem resides on an Automatic Storage Management (ASM) disk, retrieving this information requires having the ASM instance installed and configured. |
Alarms | The number of warning, critical, and fatal alarms for this Oracle database tablespace. |
This table provides the following information for tablespace metrics.
Metric Name | Description |
---|---|
Total | The total amount of space in the selected tablespace. |
Free Space | The total amount of free space in the selected tablespace. |
Used | The amount of space used in the selected tablespace. |
Allocated Space Used Percentage | The percentage of used space for non auto-extensible files in the selected tablespace. |
Free Space Percentage | The percentage of free space. |
Minimum Fragment Size | The size of the smallest fragment in the selected tablespace. |
Maximum Fragment Size | The size of the largest fragment in the selected tablespace. |
Average Fragment Size | The average size of fragments in the selected tablespace. |
Recycle Free (MB) | The total amount of space used by the recycle bin within the allocated free space of the tablespace. |
Recycle Free (%) | The percentage of recycle bin space which occupies the allocated free space of the tablespace. |
Estimated Until Full | Estimated number of days until tablespace is full. If the tablespace used space did not grow during the selected period, this field shows the indication no growth. |
Autoextensible OS Datafiles | Number of autoextensible OS datafiles (DF). |
Autoextensible ASM Datafiles | If storage is managed using Automatic Storage Management (ASM), and the ASM instance is installed and configured, displays the number of autoextensible ASM datafiles (DF). |
Manual OS Datafiles | Number of manual OS datafiles (DF). |
Manual ASM Datafiles | If storage is managed using Automatic Storage Management (ASM), and the ASM instance is installed and configured, displays the number of manual ASM datafiles (DF). |
The individual Datafile properties panel displays general properties of the selected datafile, as well as a representation of the used and free space that make up the specific datafile. The Oracle database datafile-specific panel comprises the sections listed below.
Name | Description |
---|---|
Alarms | The number of warning, critical, and fatal alarms for the selected datafile |
Property Label | Property Description |
---|---|
Datafile | The name of the datafile, including the full directory path |
Tablespace | The name of the tablespace to which the datafile belongs. |
PDB | In multitenant architectures, the name of the pluggable database. |
Size | The size of the datafile in megabytes. |
Used | The used size of the datafile in megabytes. |
% Used | The percentage of the datafile used. |
Status | Indicates whether the datafile is available: AVAILABLE INVALID |
Autoextend | Indicates whether the datafile is auto-extensible. |
Details are provided for:
For datafiles managed by ASM, the filesystem space usage cylinder is available only if the ASM instance is installed and configured. For autoextensible datafiles, the file space usage cylinder is not available.
Name | Description |
---|---|
Used (percent) | The percentage of the datafile being used. |
Used (megabytes) | The number of megabytes being used. |
Total (megabytes) | The total number of megabytes available. |
Use the Fragmentation section to view the file fragmentation status of used and free extents, using a fragmentation analysis triggered by clicking Analyze Fragmentation.
Fragmentation analysis is a resource-consuming operation. Carrying out this operation is strongly discouraged in production environment with heavy resource contention.
Name | Description |
---|---|
Fully Usable | The amount of memory that is not being used by a datafile and is viable; represented by the blue portion of the horizontal memory bar. This bar displays the file fragmentation snapshot of used and free extents. |
Partly Usable | The amount of datafile memory that is partly usable; represented by the violet portion of the horizontal memory bar. |
Unusable | The amount of tablespace memory that is unusable; represented by the pink portion of the horizontal memory bar. |
Used | The amount of tablespace memory that is used; represented by the orange portion of the horizontal memory bar. |
The Redo Logs panel, which displays details regarding all redo logs, either for the Oracle instance or for all nodes of an Oracle RAC, comprises the following sections:
Redo Logs Storage Groups Table The redo log records all changes made in datafiles.
Name | Description |
---|---|
Group # | The redo log group number. |
Group Status | The status of the redo logs indicates which logs are in use and whether there are any odd status codes, such as stale log indications or indications of corrupt redo logs. The log files can have one of the following status values: USED — indicates either that a log had just been added (never used), or that a RESETLOGS command has been issued. CURRENT — indicates a valid log that is in use. ACTIVE — indicates a valid log file that is not currently in use. CLEARING — indicates a log is being re-created as an empty log due to database administrator action. CLEARING CURRENT — indicates that a current log is being cleared of a closed thread. If a log stays in this status, it could indicate there is some failure in the log switch. INACTIVE — indicates that the log is no longer needed for instance recovery but may be needed for media recovery. |
Archived | Indicates if the redo logs are being archived. |
Sequence # | The number assigned by Oracle to each redo log file whenever a log switch occurs and LGWR begins writing to the log file. When redo log files are archived, the archived log retains its log sequence number. |
Size | The size of the log in megabytes. |
First Change # | A system-allocated number (SCN), which identifies the first time a change was recorded in this log. |
First Time | The time when the first SCN in the log was recorded. |
Alarms | The number of warning, critical, and fatal alarms for the selected Oracle database tablespace. |
Name | Description |
---|---|
Member Name | The redo log group member name. |
Member Status | The redo log group member status. This status can have one of the following values: INVALID — indicates that Oracle cannot access the redo log file. STALE — indicates a log file that is either corrupt or incomplete. If the log file’s group becomes the active group, the file becomes valid again. DELETED — indicates an online redo log file that has been dropped from the database and deleted from the disk. IN USE — identifies the currently active redo log file. |
The Fast Recovery Area panel, which displays details regarding the allocated space for fast recovery area and its usage in the Oracle database, comprises the following sections:
If the fast recovery area is not configured in the database, the Fast Recover Area panel is blank, and displays the message: “The Fast Recovery Area is not configured in the database.”
The pie chart displays only components which size is greater than zero.
This table displays only components which size is greater than zero.
The Oracle database archive logs panel comprises the following sections:
If the instance is configured not to archive, the Archive Logs panel is blank, displaying only the message “The database is not archiving”.
When monitoring a RAC, the contents of the Archive Log Destinations table vary between Whole Cluster and Instance/RAC node view, as in whole cluster view the table also includes the column Instance Name, as described below.
Name | Description |
---|---|
Instance Name | Indicates which of the RAC nodes uses the specified destination archive file. Note: The Instance Name column is displayed only in whole cluster view. From the Archive Destination column and forwards, the two tables are identical. |
Archive Destination | The name of the destination archive file. |
Destination Directory | The name of the destination directory. |
Destination Status | The current status of the destination in v$archive_dest. This destination can have one of the following values: VALID — destination was initialized and is available INACTIVE — no destination information exists DEFERRED — destination was manually disabled by the user ERROR — an error occurred during open or copy DISABLED — disabled after error BAD PARAM — parameter has errors ALTERNATE — the destination is in an alternate state FULL — the destination’s quota size has been exceeded |
Destination Total | The total size of the archive destination target. |
Destination Free Space | The total amount of free space available for the archive destination target. |
Destination Usable | The total amount of usable space available for the archive destination target. Note: The Destination Total, Destination Free Space, and Destination Usable columns display information only if the archive is managed using ASM and the ASM instance is installed and configured. |
Time to Failure | The amount of time before the archive log destination becomes full. |
Binding | The binding setting, which describes whether successful archival is required: MANDATORY OPTIONAL |
Destination Type | The type of archived log destination — either PUBLIC or PRIVATE. |
Transmit Mode | The mode in which data is transmitted across the network: SYNCHRONOUS ASYNCHRONOUS, or PARALLELSYNC |
Valid Type | The Redo log type or types that are valid for the destination: ONLINE_LOGFILE STANDBY_LOGFILE ALL_LOGFILES |
The Invalid Objects panel displays all of the database’s schema and the invalid objects detected in each schema, as well as their distribution per schema. This panel comprises the following sections:
The Invalid Objects table displays each schema in a separate row, together with invalid objects of the following types:
In addition, the table displays the total number of invalid objects and the alarms invoked as a result of the invalid objects detected in the schema.
By default, all of the schemas are monitored by the Invalid Objects collection. A schema with no invalid objects is displayed with a zero value in all of its columns. To exclude specific schemas from being monitored, use the Exclude List pane under the Collection Settings view in the Databases Administration dashboard.
For each object type (for example, Procedures) whose metric value contains data, that is: a number greater than zero, clicking the metric value displays a popup with a detailed list of all invalid objects for the specific object type in the selected schema.
The invalid objects distribution chart displays the distribution of the invalid objects for the schema selected in the Invalid Objects table.
The Database Backup panel displays various details regarding the backup of the Oracle database and datafile. This panel contains the sections listed below.
The threshold for the number of days that elapsed since the last successful full backup of a specific database can be configured by modifying the settings of the Days Since Full Backup alarm, in the Threshold section of the Alarms view in the Databases Administration dashboard.
A backup operation can have one of the following statuses:
Operations with a Completed status are indicated with a green check mark icon, while a warning icon appears near each operation whose status is other than Completed. Each backup job is identified by both the Start Time column, which indicates whether the backup was carried on a database or a datafile, and the Job ID column. Clicking the row displays a popup with the details of the backup job in the selected row.
Use the Configuration drilldown to review the current configuration settings of the Oracle agent, as well as tracking the modifications made to these settings.
This drilldown comprises the following panels:
In Whole Cluster view, use the Memory drilldown to carry out the following operations:
Use the SGA management section to review the current SGA settings for the entire RAC, using a row that contains the following indicators:
The SGA Utilization section contains a chart that displays SGA-related information in a breakdown format, which provides a representation of the size the following components occupy within the SGA memory:
Use the SGA Size section to review the breakdown of the SGA within the RAC, by means of the following components:
The SGA Pool Free Space section displays, both graphically using a chart and in a table format, the free space reserved for the following types of SGA pools for each of the RAC’s nodes:
Use the SGA management section to review the current SGA settings for the entire RAC, by means of a row that contains the following indicators:
The SGA Utilization section contains a chart that displays the instance’s current SGA size in either of the following views:
Use the SGA Size section to review the breakdown of the SGA within the instance, by means of the following components:
The Free Space section displays, both graphically using a chart and in a table format, the free space reserved for the following types of SGA pools for each of the RAC’s nodes:
The Initialization Parameters panel displays the entire list of initialization parameters, as defined by Oracle. These parameters define the characteristics of each Oracle instance when the instance is started. Upon clicking anywhere on a row that displays a specific initialization parameter, a popup appears, listing the properties of the selected parameter:
The Initialization Parameters table varies between instance mode and RAC mode. In Instance mode, the table displays the following columns.
Initialization Parameters for Instance mode
Name | Description |
---|---|
Parameter | Parameter name. |
PDB | In multitenant architectures, the name of the pluggable database. |
PDB is Modifiable | Hidden by default. In multitenant architectures, displays the list of pluggable databases that have been modified. |
Current Value | The parameter’s current value. |
Default | Indicates whether the parameter’s current value is its default value, as defined by Oracle. |
Dynamic | Indicates whether the initialization parameter is dynamic, that is, can be modified using the ALTER SESSION, ALTER SYSTEM, or ALTER SYSTEM DEFERRED commands while an instance is running. |
Modified | Indicates whether the parameter’s value has been modified. |
Deprecated | Indicates whether the parameter is deprecated, in which case specifying it in a parameter file will invoke a warning message when the instance starts. |
Type | The parameter type, as defined by Oracle. |
Description | The parameter description, taken from Oracle site. |
PDB_modifiable | Indicates whether the pluggable database can be modified. Note: This column is not displayed by default |
In RAC mode, the Initialization Parameters panel can be accessed by selecting either the Whole Cluster or a specific instance view. In the Whole Cluster view, instance-specific initialization parameters are displayed with the icon to the left of the parameter name, and the names of the various instances are displayed in the Scope column. The following columns in Initialization Parameters table differ in RAC mode.
Name | Description |
---|---|
Parameter | Parameter name. A ‘+’ icon to the left of the name indicates that the parameter applies differently to specific instances. |
Scope | Indicates whether the parameter applies to the entire RAC or varies between specific instances. |
Current Value | The parameter’s current value. This value can be either instance-specific or apply to the entire RAC. |
The Alerts drilldown provides a view on the alert and error logs received for a selected Oracle agent during the specified time range. This drilldown comprises the following panel:
Both the Error Log and Alert Log panels are displayed only at the instance level. Selecting the Error Log or Alert Log menu item from within a RAC, when the Whole Cluster view is selected, displays a message that prompts the selection of the requested instance.
By default, the Alert Log panel displays all of the alert log messages. To display messages under a pre-defined name, category and severity, create or edit patterns for these messages in the Match List, which is found in the Alert Log view in the Databases Administration dashboard, and add the corresponding regular expressions to this list. To prevent messages from being displayed on the Alert Log panel, add these messages to the Ignore List.
Only messages that are explicitly defined in the Ignore List will not be displayed. Messages that were not added to either the Match or Ignore lists appear with the name Other, the type of Oracle alert messages, and the severity Information. Therefore, ensure that messages that do not need to be displayed are added to the Ignore List.
The Alert Log Messages chart provides a graphic, color-coded representation of the various alert log messages, broken down by their severity level, as described below.
The Alert Log Messages table provides the following details about each alert log:
Both Name and Type refer to the parameters defined using the Alert Log view in the Databases Administration dashboard.
Starting in version 5.7.5.50, Foglight for Oracle provides a detailed dashboard for monitoring Data Guard environments. The Data Guard environment information is presented only after Data Guard environments are configured. The Data Guard tab lists all Data Guard environments which have been configured.
To access the detailed dashboard for that Data Guard environment, click the name of that Data Guard environment under the Name column.
The Data Guard dashboard displays a Data Guard status, provides information about Primary and Standby databases, monitors progress and performance of log transfer and apply processes. The Data Guard dashboard has three tabs:
The Summary tab displays information about all Primary and Standby databases that are configured for the Data Guard environment. It comprises the following sections:
Gap Time Chart is available for Standby databases that are monitored by users that have SYSDBA privileges.
The Performance tab displays the following charts:
Estimated Failover chart is available for Standby databases that are monitored by users that have SYSDBA privileges.
The log shipping status tab contains information about non received and non applied logs into Physical Standby databases of the configured Data Guard environment. It comprises the following sections:
Starting in version 5.6.5.5, Foglight for Oracle provides a detailed dashboard for monitoring ASM performance. The ASM information is presented only after ASM instances are configured. The ASM tab lists all ASM instances which have been configured. To access the detailed dashboard for that instance, click the home button.
The ASM dashboard provides information about the ASM cluster/instance, it includes general instance information, Disk groups and disks information, ASM Parameters and ASM Alert log information. The ASM dashboard has three tabs:
The summary tab contains information about all the disk groups that are configured for the ASM, as well as the disks that are configured for each ASM disk group. This information includes the version number, status, total storage space, and the number of ASM clients. The number of ASM clients is clickable and opens a pop-up that shows all the Oracle instances that are using a disk group managed by the ASM instance. It also has a column named Monitored that gives an indication whether or not that Oracle instance is monitored by Foglight. If the Oracle instance is not monitored by Foglight, it is possible to monitor it immediately by clicking Monitor. The Disk Groups table provides detailed information about each group. Selecting one or more disk groups will display additional information in the pane below, either in Map or Table View. Each disk group in the top table or disk in the Map or Table view is clickable and opens a pop-up with additional information.
For disk groups, the pop-up includes the following tabs:
If you select a specific disk in the Map or Table view, the pop-up includes the following tabs:
The Parameters tab displays a list of all the ASM parameters and their values, as well as some other additional information for each parameter.
The Alert log tab displays the entire alert log messages with the relevant severity, as defined in the Match List. Only messages that appear in the Ignore List will not be displayed in this screen.