Teradata Viewpoint User Guide
Below you will find brief information for Teradata Viewpoint. The Teradata Viewpoint provides a portal for viewing and managing Teradata system data. The portal provides a framework for displaying and updating portlets. Each portal page is a virtual work space where you decide which portlets to display and how to arrange them on the page.
Advertisement
Advertisement
Teradata Viewpoint
User Guide
Release 13.03
B035-2206-020A
February 2010
The product or products described in this book are licensed products of Teradata Corporation or its affiliates.
Teradata, BYNET, DBC/1012, DecisionCast, DecisionFlow, DecisionPoint, Eye logo design, InfoWise, Meta Warehouse, MyCommerce,
SeeChain, SeeCommerce, SeeRisk, Teradata Decision Experts, Teradata Source Experts, WebAnalyst, and You’ve Never Seen Your Business
Like This Before are trademarks or registered trademarks of Teradata Corporation or its affiliates.
Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc.
AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc.
BakBone and NetVault are trademarks or registered trademarks of BakBone Software, Inc.
EMC, PowerPath, SRDF, and Symmetrix are registered trademarks of EMC Corporation.
GoldenGate is a trademark of GoldenGate Software, Inc.
Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company.
Intel, Pentium, and XEON are registered trademarks of Intel Corporation.
IBM, CICS, RACF, Tivoli, z/OS, and z/VM are registered trademarks of International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
LSI and Engenio are registered trademarks of LSI Corporation.
Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the
United States and other countries.
Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation.
SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc.
SPARC is a registered trademark of SPARC International, Inc.
Sun Microsystems, Solaris, Sun, and Sun Java are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries.
Symantec, NetBackup, and VERITAS are trademarks or registered trademarks of Symantec Corporation or its affiliates in the United States and other countries.
Unicode is a collective membership mark and a service mark of Unicode, Inc.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
The information contained in this document is provided on an “as-is” basis, without warranty of any kind, either express or implied, including the implied warranties of merchantability, fitness for a particular purpose, or non-infringement.
Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. In no event will Teradata Corporation be liable for any indirect, direct, special, incidental, or consequential damages, including lost profits or lost savings, even if expressly advised of the possibility of such damages.
The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country.
Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice.
To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please e-mail: [email protected]
Any comments or materials (collectively referred to as “Feedback”) sent to Teradata Corporation will be deemed non-confidential. Teradata
Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis.
Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback.
Copyright © 2008 - 2010 by Teradata Corporation. All Rights Reserved.
Table of Contents
Chapter 1:
Teradata Viewpoint Help
Chapter 2:
Getting Started
Chapter 3:
Portal Basics
Chapter 4:
Portlet Basics
Chapter 5:
Portal and Portlet Tools
Teradata Viewpoint User Guide 3
Table of Contents
Chapter 6:
Profile
Chapter 7:
System Administration
Chapter 8:
Alert Viewer
4 Teradata Viewpoint User Guide
Table of Contents
Chapter 9:
Calendar
Chapter 10:
Canary Response Times
Chapter 11:
Capacity Heatmap
Chapter 12:
External Content
Chapter 13:
Lock Viewer
Teradata Viewpoint User Guide 5
Table of Contents
6
Chapter 14:
Metrics Analysis
Chapter 15:
Metrics Graph
Chapter 16:
My Queries
Chapter 17:
Node Resources
Chapter 18:
Productivity
Teradata Viewpoint User Guide
Table of Contents
Chapter 19:
Query Monitor
Chapter 20:
Remote Console
Chapter 21:
Space Usage
Chapter 22:
SQL Scratchpad
Teradata Viewpoint User Guide 7
Table of Contents
8
Chapter 23:
System Health
Chapter 24:
Today's Statistics
Chapter 25:
Viewpoint Monitoring
Chapter 26:
Workload Health
Chapter 27:
Workload Monitor
Teradata Viewpoint User Guide
Table of Contents
Teradata Viewpoint User Guide 9
Table of Contents
10 Teradata Viewpoint User Guide
CHAPTER 1
Teradata Viewpoint Help
Teradata Viewpoint Help
The Teradata Viewpoint Help online user guide provides targeted information about how to use the Teradata Viewpoint portal and related system management tools, called portlets, to manage your Teradata Database system.
Click to open a browser containing Teradata Viewpoint Help. The display is divided into panes:
Contents Lists the hierarchy of topics contained in Teradata Viewpoint Help. To navigate using this pane:
• Click next to a topic name to expand the list of available topics.
• Click next to a topic name to collapse the list of available topics.
• Click on any topic name to display corresponding topic information in the right pane.
Current
Help Topic
Displays the currently selected Help topic. In this pane, you can:
• Browse through topic information, using the Scroll Bar to view content not visible in the pane.
• Select links to related topics that are above (parent) or below (child) the current topic in the content hierarchy.
Note: Only one instance of the Help system can be displayed regardless of how many sessions are open.
Teradata Viewpoint User Guide 11
Chapter 1 Teradata Viewpoint Help
Teradata Viewpoint Help
12 Teradata Viewpoint User Guide
CHAPTER 2
Getting Started
Getting Started
Getting Started topics describe how to begin and end a Teradata Viewpoint session.
Logging On
Logging on to the Teradata Viewpoint portal begins your session so you can begin working with the Teradata Viewpoint portal.
1
2
3
Open a browser.
Enter the address for your Teradata Viewpoint portal.
The Welcome page appears, with the portal version number shown at the bottom.
Log on to the Teradata Viewpoint portal.
If your Teradata Viewpoint system is set up to create a user profile automatically, the username and password you enter are authenticated against your company-provided username and password the first time you log on to Teradata Viewpoint. Automatic profile creation is known as auto-provisioning.
Logging Off
Logging off the Teradata Viewpoint portal ends your current session and returns you to the
Welcome page.
1
From the Teradata Viewpoint main menu bar, click Logout to exit the portal.
All page content is preserved for your next Teradata Viewpoint session. Any open
Teradata Viewpoint Help window is closed.
Teradata Viewpoint User Guide 13
Chapter 2 Getting Started
Getting Started
14 Teradata Viewpoint User Guide
CHAPTER 3
Portal Basics
Portal Basics
To help you work efficiently, Teradata Viewpoint uses a page metaphor as the framework for displaying and updating portlets. Each portal page is a virtual work space where you decide which portlets to display and how to arrange them on the page. Examples of ways to organize your work include defining a page for each system being monitored, or for each type of query or user. As you work, Teradata Viewpoint continually updates the information displayed on the page that currently fills the Teradata Viewpoint portal. This page is called the active page.
Manage portal pages using the following guidelines:
• Add portal pages at any time during a Teradata Viewpoint session.
• Access any portal page by clicking its tab; only one page can be active at a time.
• Change the name of any tab, including the Home page tab; page names can be duplicated.
• Rearrange pages by dragging and dropping into a new location.
• Remove pages, along with any portlets contained on the page, with a single mouse-click.
• One page (tab) must remain, as well as the Add Page tab.
Adding a Portal Page
Organize your system management tools by adding pages to the Teradata Viewpoint portal.
Multiple pages can be added or removed per session. The newest page is always the active page unless you click on another tab.
1
In the Teradata Viewpoint portal, click Add Page.
A New Page tab appears to the left of Add Page and becomes the active page.
Teradata Viewpoint User Guide 15
Chapter 3 Portal Basics
Portal Basics
Naming a Portal Page
One way you can customize the Teradata Viewpoint portal is by giving meaningful names to the pages that display portlets. Initially, each page is named New Page. You can change the page name at any time during a Teradata Viewpoint session.
1
Click on the page tab to highlight the page name.
2
3
4
Enter the new name.
Page names can be up to 30 characters long.
To apply the new name, do one of the following:
• Click anywhere on the portal page.
• Press Enter.
[Optional] Reorder the portal pages to maintain your management scheme.
Arranging Portal Pages
Initially portal pages appear in the order in which they have been added from left to right.
Arranging or rearranging pages does not change page content, and can be done at any time during your Teradata Viewpoint session.
1
In the portal task bar, mouse over the tab you intend to move.
The cursor changes to a directional cursor.
2
Drag the tab to the left or to the right of its current position.
The tab aligns in the new position.
Add Page is always in the right-most position and cannot be moved or deleted.
Deleting a Portal Page
A portal page and its contents can be deleted from the portal at any time after it has been defined and at any time during your Teradata Viewpoint session.
1
In the portal task bar, click the tab of the page you intend to delete.
16 Teradata Viewpoint User Guide
2
3
Click to remove the portal page and its contents.
A confirmation message appears.
Click OK to delete the page.
The page is removed, and the remaining tabs shift left.
Chapter 3 Portal Basics
Portal Basics
Teradata Viewpoint User Guide 17
Chapter 3 Portal Basics
Portal Basics
18 Teradata Viewpoint User Guide
CHAPTER 4
Portlet Basics
Portlet Basics
Teradata Viewpoint system management tools are called portlets. Select the portlets that you want to display and monitor from submenus, or categories, under Add Content. You can also search for a specific portlet name using the filter feature. Generally, every instance of a portlet:
• Has a frame that appears when the cursor moves over any part of the portlet on the page and disappears when the cursor moves off the portlet.
• Displays the portlet name or the current settings in the upper frame, depending on the current activity.
• Has a width requirement to ensure proper display of its graphical information such as charts, sparklines, or graphs.
• Remains at a fixed size even when the browser window is re-sized. You can use the browser scroll bars to view the entire portlet view.
• Can be repositioned on the portal page.
Portlet Controls
The Teradata Viewpoint Administrator controls what portlets and features you are authorized to use. If a portlet or feature is not available, your Teradata Viewpoint
Administrators can assign permissions. The following controls appear within each portlet frame if the control is available:
Teradata Viewpoint User Guide 19
Chapter 4 Portlet Basics
Portlet Basics
Back
Rewind
Returns to the previous view.
Indicates that the portlet can be set to display data from a previous point in time.
what information is displayed, time intervals for reporting, and other features that help you customize the portlet functions.
Share Portlet Captures a customized version of a portlet for use by other users. The
Teradata Viewpoint Administrator must make the customized portlet available for sharing.
Collapse Toggles the portlet closed. This button appears only when the portlet is open. When collapsed, only the upper and lower portlet frame sections are displayed.
Expand
Maximize
Minimize
Toggles the portlet open. This button appears only when the portlet is collapsed. When expanded, the portlet returns to its normal size and position on the portal page.
Toggles the portlet to fill the portal page, covering all other portlets being displayed.
Toggles the portlet to the default size of one column wide.
Remove Removes the portlet and all its settings from the active portal page.
Each portlet instance has its own settings and controls as well as the features shared by all portlets. Depending on the specialized nature of the portlet, a portlet can include any of the following features:
• Tabs for accessing views, when views are available to organize settings according to function.
• Selection menus above the toolbar to choose detailed information.
• A toolbar with buttons for quick access to information.
• Date-range slider for selecting start dates and end dates for analysis.
• Information balloons to show detailed information when you mouse over the portlet.
Adding a Portlet
A portlet can be added to the active page at any time during a session. Except for the
CALENDAR portlet, multiple instances of a portlet can be added to a portal page.
1
In the portal, click Add Content.
20 Teradata Viewpoint User Guide
2
Select a portlet from the submenus.
Chapter 4 Portlet Basics
Portlet Basics
3
The portlet is added at the top of the left-most column.
[Optional] Reposition the portlet on the portal page by dragging it to another location.
Filtering Portlets
Find a portlet by using the keyword filter box and the SEARCH RESULTS list.
Note: This method is also useful when you want to add a portlet to the active page and the list of portlets is long.
1
2
Click in the keyword filter box to activate the field for typing.
Begin typing the portlet name.
As you type, the SEARCH RESULTS list shows the portlets that match your filter criteria.
Note: This field is not case-sensitive.
3
Click a portlet name in the SEARCH RESULTS list to add it to the page.
Deleting a Portlet
A portlet can be deleted from the active portal page at any time. Deleting a portlet resets portlet information and deletes any custom settings set for that instance only. Other portlet instances on the same page or on other pages are not affected.
1
On the active portal page, mouse over the portlet frame to activate the portlet.
Note: The portlet does not need to be expanded if it is collapsed.
Teradata Viewpoint User Guide 21
Chapter 4 Portlet Basics
Portlet Basics
2
3
Click to remove the portlet from the portal page.
A confirmation message appears.
Click OK.
The portlet is removed from the active portal page.
22 Teradata Viewpoint User Guide
CHAPTER 5
Portal and Portlet Tools
Portal and Portlet Tools
Portal and Portlet Tools topics describe the tools that control the functions accessed from the portal and portlet frames. These tools are generally available to all users and allow you to customize the Teradata Viewpoint portal and portlets to make managing and working with system data more efficient. Use these functions to customize Teradata Viewpoint and streamline your workflow:
• Rewind
• Pause
• Share Portlet
About the Rewind Feature
The rewind feature allows you to view data that corresponds to dates and times in the past and compare it to data for a different date and time. You can rewind the data for some or all portlets on a portal page to a previous point in time, such as when a job failed. Rewinding portlet data is useful for identifying and resolving problems.
Note: You can rewind data as far back as data is available. The rewind feature is not available for portlets that have portlet-specific methods for reviewing data over time.
Using the rewind toolbar, you can enter a specific date and time as well as scroll through the data in increments of seconds, minutes, hours, or days. All portlets on the page that are participating in rewind activities display data that corresponds to the selected rewind date and time each time a selection is made.
If portlet data can be rewound, a time stamp, , and appear in the portlet frame.
You can also do the following:
• Pause individual portlets so that the data display is no longer rewound or refreshed
Teradata Viewpoint User Guide 23
Chapter 5 Portal and Portlet Tools
Portal and Portlet Tools
• Resume participation in rewind for a portlet in pause mode
• Prevent a portlet from participating in rewind and display current data instead
• Resume participation in rewind and return to the state a portlet was in when it was unlinked from rewind
• Cancel the rewind feature so that all rewound portlets on the portal page display current data
Note: Permission to use the rewind feature is granted to individual users based on their role and portlet access. If the rewind toolbar does not appear on the portal page, you are not authorized to use the feature. If the rewind icons and time stamp do not appear in the portlet frame, the feature is not available for that portlet.
Rewinding a Portal Page
This task describes how to rewind all participating portlets on a portal page. Use the rewind feature to:
• Select a date and time for data to display in all participating portlets currently on a portal page or added to the page.
• Scroll the selected time incrementally to find a change in status among the participating portlets displayed on the page.
1
Click .
The Rewind toolbar appears along the top of the portal page.
2
3
4
[Optional] Specify the date and time: a
Enter a date in the Desired Date and Time date field.
b
Enter a time in the Desired Date and Time time field.
c
Click anywhere in the portal page to display the data that corresponds to the selected date and time for all participating portlets.
[Optional] Drag left to scroll back through time in increments of:
• 1 second
• 10 seconds
• 1 minute
• 10 minutes
• 1 hour
• 1 day
[Optional] Drag right to scroll forward through time in increments of:
• 1 second
• 10 seconds
• 1 minute
• 10 minutes
• 1 hour
• 1 day
24 Teradata Viewpoint User Guide
Chapter 5 Portal and Portlet Tools
Portal and Portlet Tools
Note: You cannot scroll forward past the current time (projected data is not available using the rewind feature).
Pausing Rewind for a Portlet
This task describes how to pause an individual portlet on a portal page while other portlets on the page display rewound data. Pausing an instance of a portlet freezes the display of data at the moment the portlet is placed in pause mode, allowing you to compare data for multiple rewound time periods.
1
2
Click in the portlet frame.
Click Pause.
Data displayed in the portlet becomes static and does not change until you resume the portlet refresh rate.
Resuming Rewind for a Portlet
This task describes how to resume using the rewind feature for an individual portlet on a portal page that is in pause mode.
1
2
Click in the portlet frame.
Click Resume.
Data displayed in the portlet is updated to the selected rewind time and does not change until the selected date or time for the rewind feature is changed.
Stopping Rewind Participation
This task describes how to prevent an individual portlet from participating in rewind when the portlet frame displays .
1
2
Click in the portlet frame.
The portlet can be in pause mode or actively responding to the rewind date and time controls.
Click Unlink from Rewind.
The portlet no longer responds to rewind date or time controls and is updated to display the most recent data available.
Restarting Rewind Participation
This task describes how an individual portlet not participating in rewind resumes participation when the portlet frame displays .
1
2
Click in the portlet frame.
Click Link to Rewind.
The portlet returns to the mode it was in when it was unlinked from participation in rewind. For example, if the portlet was in pause mode when unlinked from rewind, it is in pause mode when participation in rewind resumes.
Teradata Viewpoint User Guide 25
Chapter 5 Portal and Portlet Tools
Portal and Portlet Tools
Canceling the Rewind Feature
This task describes how to turn off the rewind feature and resume display of current data in all portlets on the portal page.
1
Click Cancel.
All portlets on the portal page that were participating in rewind activities end participation and display the most recent data available.
About the Pause Feature
Any rewindable portlet can be paused from refreshing data. Pausing an instance of a portlet freezes the display of data at the moment the portlet is placed in pause mode, allowing you to compare data for different time periods. The rewind feature does not need to be active to pause the portlet.
Note: When a portlet is in pause mode, the time stamp flashes, indicating that the data in the portlet is no longer being refreshed.
Pausing Portlet Refresh
This task describes how to pause an individual portlet on a portal page.
1
2
Click in the portlet frame.
Click Pause.
Data displayed in the portlet becomes static and does not change until you resume the portlet refresh rate.
Restarting Portlet Refresh
This task describes how to resume the portlet refresh rate when the portlet is in pause mode.
1
2
Click in the portlet frame.
To restart the portlet, do one of the following:
• Click Refresh to refresh portlet summary and detail data to the current date and time.
• Click Resume to resume the portlet refresh rate.
About Shared Portlets
Use the Share Portlet feature to make a customized or preconfigured version of a Teradata
Viewpoint portlet available to other users. When the shared portlet is added to a portal page, all preferences and settings you selected when you customized the portlet are used.
Any user can customize a shareable portlet and submit it for sharing. Depending on your
Teradata Viewpoint system configuration, the portlet is not available to authorized users until the Teradata Viewpoint Administrator approves the request. Only the Teradata
Viewpoint Administrator can delete the shared portlet entirely. If deleted, existing instances remain on your portal page. However, a warning message appears if you try to access the portlet.
The Shared Portlets feature allows you to:
26 Teradata Viewpoint User Guide
Chapter 5 Portal and Portlet Tools
Portal and Portlet Tools
• Share customized views of a Teradata Viewpoint portlet with other users.
• Create different configurations of a portlet for different roles.
• Assign a preconfigured portlet to a role as a default instance of the portlet.
• Assign a name to the preconfigured portlet.
The portlet name appears in the Shared submenu of the Add Content menu. The Shared submenu only appears when at least one shared portlet is enabled for the user who is logged on.
Creating a Shared Portlet
Use the Share Portlet feature to customize a Teradata Viewpoint portlet and make it available to other users.
1
Add a portlet instance that you want to share to your portal page.
2
3
4
5
6
7
8
From the portlet frame, click to access the PREFERENCES view.
Customize the portlet using the available preference settings.
Click OK to save the settings.
Click to access the SHARE PORTLET dialog box.
Enter a name for the custom portlet using up to 25 alphanumeric characters.
Note: Depending on your Teradata Viewpoint system configuration, the portlet is not available to authorized users until the Teradata Viewpoint Administrator approves your request.
Click Save.
[Optional] Contact the Teradata Viewpoint Administrator to verify that the portlet has been received for approval.
Teradata Viewpoint User Guide 27
Chapter 5 Portal and Portlet Tools
Portal and Portlet Tools
28 Teradata Viewpoint User Guide
CHAPTER 6
Profile
Profile
The Profile portlet provides tabs that allow you to set your personal user settings and manage your Teradata Database profile information:
Personal Info Change your name, change your password (if authorized), and set Teradata
Viewpoint preferences.
Teradata
Profiles
Manage settings for each of your Teradata Database user profiles. Link your Teradata profile to the Teradata Database systems you are authorized to access.
Access the Profile portlet from the Teradata Viewpoint portal main menu bar.
About the Personal Info Tab
The Profile view, Personal Info tab, allows you to manage your Teradata Viewpoint profile:
• Change the first and last name for the profile.
• Change your Email address.
• Change your Password.
• Change your Language.
• Change your Format.
• Select the Time Zone.
Teradata Viewpoint User Guide 29
Chapter 6 Profile
Profile
30
Use the Personal Info tab to set the local Teradata Viewpoint language and format. Select the language to display information in the local language. Select the format to display all dates, times, and numbers in the correct format for the country. Supported formats include:
• Chinese (China and Taiwan)
• English (US and UK)
• French
• German
• Japanese
• Korean
The language and format you enter is applied to the entire Teradata Viewpoint session and is maintained in future sessions.
The list of available languages is determined by the language packs installed. If the language you want does not appear in the list, contact your Teradata Viewpoint Administrator.
Changing a Name
This task describes how to change the first and last name for a Teradata Viewpoint profile.
1
2
3
4
From the Profile view, click the Personal Info tab.
Change the name in the First Name field.
Change the name in the Last Name field.
Click Apply.
A confirmation message appears.
Teradata Viewpoint User Guide
Chapter 6 Profile
Profile
Setting a Contact Email Address
This task describes how to set your Email address using the Personal Info tab. This email address is used for identification and communication in the Teradata Viewpoint system, including notifications and reminders.
The email address cannot contain uppercase letters. Uppercase characters are automatically converted to lowercase.
1
2
3
From the Profile view, click the Personal Info tab.
Enter your full address in the Email field.
Click Apply.
A confirmation message appears.
Managing Passwords
This task describes how to manage Teradata Viewpoint profile passwords. A password must be 4 to 25 characters in length.
A user cannot change their password if their profile is externally authenticated. The fields required to change the password are not available when external authentication is used. To change the password on an externally authenticated profile, follow your company policy for password management.
1
2
3
4
5
From the Profile view, click the Personal Info tab.
Enter your current password in the Current Password field.
Enter a new password in the New Password field.
Confirm your new password by retyping it in the Re-enter New Password field.
Click Apply.
A confirmation message appears.
Setting the Language and Format
This task describes how to set the local language and set the format to display all dates, times, and numbers in the correct format for the country for Teradata Viewpoint.
1
2
3
4
From the Profile view, click the Personal Info tab.
Select the language from the list.
The Teradata Viewpoint application server language is the default.
Select the format from the list.
The Teradata Viewpoint application server format is the default.
Click Apply.
A confirmation message appears.
Setting the Time Zone
This task describes how to adjust your local Teradata Viewpoint time zone setting to compensate for different time zones. Select the local time zone to display all time and date
Teradata Viewpoint User Guide 31
Chapter 6 Profile
Profile information in the local date and time, even if the Teradata Database system you are monitoring is located in a different time zone.
The time zone you enter compensates for the time difference between the monitored system location and the Teradata Viewpoint reporting location.
1
2
From the Profile view, click the Personal Info tab.
Select a time zone from the list.
Time zones shown are relative to Greenwich Mean Time (GMT) and include a reference location. The Teradata Viewpoint application server time zone is the default. To view more time zones, use the scroll bar.
3
Click Apply.
A confirmation message appears.
About the Teradata Accounts Tab
Use the Teradata Accounts tab in the Profile view to manage Teradata Database account logon and profile information for each Teradata Database system. Teradata account information is used by the MY QUERIES portlet. For each Teradata Database system, you can:
• Add accounts
• Edit existing profiles
• Delete profiles
System profiles added using the Teradata Accounts tab must already exist on the monitored system. The system validates the USERNAME, PASSWORD, and ACCOUNT STRING fields prior to confirmation.
32 Teradata Viewpoint User Guide
Chapter 6 Profile
Profile
Adding a User Profile
This task explains how to associate Teradata Database profiles with your Teradata
Viewpoint profile.
1
2
3
4
From the Profile view, click the Teradata Accounts tab.
Under Add Account, select a Teradata Database system from the list.
Enter the following information in the appropriate fields:
• Username
• Password
• [Optional] Account string
Click Add.
A confirmation message appears.
Editing a User Profile
This topic explains how to edit a Teradata Database system user profile in Teradata Viewpoint.
1
2
From the Profile view, click the Teradata Accounts tab.
Mouse over the row containing the user profile information for the Teradata Database system you are updating.
The row is highlighted, and Edit and Delete appear.
3
4
5
6
Click Edit to the right of the row containing the user profile information.
Edit any of the following fields:
• PASSWORD
• ACCOUNT STRING
[Optional] Click Test to verify that the logon settings are correct.
A confirmation message appears.
Click Save to save your changes.
A confirmation message appears.
Teradata Viewpoint User Guide 33
Chapter 6 Profile
Profile
Deleting a User Profile
This task explains how to delete a Teradata Database system user profile from Teradata
Viewpoint using the Profile view, Teradata Accounts tab.
1
2
From the Profile view, click the Teradata Accounts tab.
Mouse over the row containing the Teradata Database user profile information for the system you are updating.
The row is highlighted, and Edit and Delete appear.
3
Click Delete to the right of the row containing the user profile information.
If the deletion is successful, a confirmation message appears.
34 Teradata Viewpoint User Guide
CHAPTER 7
System Administration
System Administration
The Teradata Viewpoint administrative portlets allow the Teradata Viewpoint
Administrator to provide access to Teradata Viewpoint resources and information.
Configuration portlets
PORTLET
LIBRARY
ROLES
MANAGER
USER
MANAGER
TERADATA SYSTEMS Configure, enable, and disable Teradata
Viewpoint servers and data collectors. After a server is defined to
Teradata Viewpoint, you can maintain logins, accounts, passwords, and character set settings.
MANAGED SERVERS Configure, enable, and disable managed servers.
ALERT SETUP Configure alerts or migrate Teradata Manager alerts.
LDAP SERVERS Configure LDAP servers to authenticate, autoprovision, and map Viewpoint roles to Teradata Viewpoint users.
BACKUP Configure daily backups.
Select portlets for activation. Using a simple checklist, you can either enable or restrict access to available Teradata Viewpoint portlets.
Manage roles, assign users, and grant permissions efficiently. After a role is created, you can customize the role by assigning users, enabling portlets, grant permissions for metrics, and granting user permissions for portlets.
Manage Teradata Viewpoint user accounts by creating user accounts, assigning or resetting passwords, and assigning users to predefined roles.
Alert Setup
Alert Setup
The ALERT SETUP portlet allows Teradata Viewpoint Administrators to configure the
Alert Service to perform any of the following actions in response to alerts:
• Write to the alert log
• Send email notifications
• Send SNMP notifications
• Run BTEQ scripts
Teradata Viewpoint User Guide 35
Chapter 7 System Administration
Alert Setup
• Run programs
Teradata Viewpoint Administrators can also configure the following alert presets:
• Core hours of operation
• Action sets of multiple alert actions run in a single operation
• Groups of multiple alert action sets run in a single operation
Administrators can set time periods and file-size restrictions for retention of alert log data.
Settings configured in the ALERT SETUP portlet determine data displayed in the ALERT
VIEWER portlet.
Setting Alert Retention
You can set limits on how long to retain alert log data and how much to retain.
1
2
3
4
From the SETUP OPTIONS list, click Delivery Settings.
From the DELIVERY TYPES list, click Alert Log.
Under Delete Alert Log Data, do any of the following:
• Select the After check box to set the retention period using a number and calendar value.
• Select the Over check box, and then set the file-size restriction using the Over box and list.
Click Apply to apply the settings.
If you set a retention period, then after the specified period expires, alert log data is deleted in weekly increments. If you set a file-size restriction, then after the specified file size is exceeded, alert log data is deleted in weekly increments with the oldest data being deleted first.
Configuring Email Settings for Alerts
You can configure the Alert Service to send alert notifications by email.
1
2
3
4
5
From the SETUP OPTIONS list, click Delivery Settings.
From the DELIVERY TYPES list, click Email.
Under SMTP Host, do the following: a
In the box, type the host address of the outgoing (SMTP) email server.
b
[Optional] Select the Use SSL check box to use Secure Sockets Layer as the transmission protocol.
Under Port, do one of the following:
• Select Use default port to use the default communications port on the SMTP host for outgoing email.
• Select Enter port number, and in the box, type the custom port number for the
SMTP host to use for outgoing email.
In the Server Timeout box, type the number of seconds the system must wait to establish a connection with the SMTP host before timing out.
The default is 30 seconds.
36 Teradata Viewpoint User Guide
Chapter 7 System Administration
Alert Setup
6
7
8
9
10
In the Reply-to box, type the email address to use as the Reply-to address in delivered alert email messages.
Under Login, do one of the following:
• Select Anonymous login to log on to the SMTP host anonymously.
• Select Enter credentials and in the boxes type a Username and Password to use to log on to the SMTP host.
Leave the Advanced box empty.
To test your email delivery settings, type a valid recipient email address in the Test
Recipient box and click Test.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
If the test is successful, an email message is sent to the test recipient address, addressed from the email address specified in the Reply-to box.
Click Apply to apply the settings.
Adding and Editing SNMP Configurations for Alerts
You can configure the Alert Service to deliver alert notifications to third-party management applications using SNMP.
1
2
3
4
5
6
From the SETUP OPTIONS list, click Delivery Settings.
From the DELIVERY TYPES list, click SNMP.
From the SNMP list, do one of the following:
• To add an SNMP configuration, click .
• To copy an SNMP configuration, click in the row of the configuration you want to copy.
• To edit an SNMP configuration, click the name of the configuration.
In the Configuration Name box, type a name for the SNMP configuration.
In the Destination box, type the IP address or host name of the destination for SNMP alert notifications.
In the Community box, type a name for the SNMP community.
The default is public
.
7
8
You also have the option to add or remove Destination and Community pairs.
To test the SNMP configuration on the specified destination host or hosts, click Test.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
If the test is successful, the Alert Service sends an SNMP trap (notification) to each specified destination. Verify that the SNMP trap is received at each destination.
[Optional] Select the Default for Alert Request Collector check box to make this the default configuration for SNMP requests originating from the AlertRequest and
MonitorRequest tables in the dbcmngr database.
Teradata Viewpoint User Guide 37
Chapter 7 System Administration
Alert Setup
9
Note: Making this configuration the default clears the previous default.
Click Apply to apply the settings.
Adding and Editing BTEQ Configurations for Alerts
You can configure the Alert Service to run BTEQ alert actions.
1
2
3
4
5
6
7
8
9
10
From the SETUP OPTIONS list, click Delivery Settings.
From the DELIVERY TYPES list, click BTEQ.
From the BTEQ list, do one of the following:
• To add a BTEQ configuration, click .
• To copy a BTEQ configuration, click in the row of the configuration you want to copy.
• To edit a BTEQ configuration, click the name of the configuration.
In the TDPID box, type the TDPID of the Teradata Database you want to log on to.
The BTEQ scripts are run against the specified TDPID.
Note: The TDPID must match the configuration in the TERADATA SYSTEMS portlet.
[Optional] In the Account ID box, type the logon account ID under which to run the
BTEQ configuration.
The account ID is associated with the Username specified in this pane.
Select a Session Character Set from the list.
In the boxes, type a valid Username and Password to use to log on to the specified TDPID.
[Optional] Type a Logmech Name and Logmech Data in the boxes.
Logmech Name is the logon mechanism, and Logmech Data is the logon data
(parameters or credentials) for the selected mechanism.
To test the BTEQ configuration on the specified TDPID, click Test.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
Click Apply to apply the settings.
Deleting SNMP or BTEQ Configurations
Note: You cannot delete a BTEQ configuration if it is used in an action set, or if it is the last configuration for a defined BTEQ alert action.
Note: You cannot delete an SNMP configuration if it is used in an action set.
1
2
3
4
From the SETUP OPTIONS list, click Delivery Settings.
From the DELIVERY TYPES list, click SNMP or BTEQ.
From the SNMP or BTEQ list, click to delete a configuration.
A confirmation message appears.
Click OK.
38 Teradata Viewpoint User Guide
Chapter 7 System Administration
Alert Setup
About Core Hours
The Alert Service operates 24 hours a day, 7 days a week.
You can schedule alert actions to run during one or more of the following times:
• Core hours
• Evening hours
• Weekend hours
Core hours are set as specific days of the week, with either a specific time interval or all day
(24 hours).
Evening hours and weekend hours are defined as follows:
• Evening hours. On core days, the hours opposite the core hours.
• Weekend hours. The ending time of the ending core day to the beginning time of the beginning core day.
Time Interval
If the core hours are Monday through Friday, 9:00 AM to 5:00 PM, then evening hours are Monday through Friday, 5:00 PM to 9:00 AM, and weekend hours are from Friday at
5:00 PM through Monday at 9:00 AM.
All Day
If the core hours are Monday through Friday, 24 hours, then there are no evening hours, and weekend hours are Saturday through Sunday, 24 hours.
Setting Core Hours
1
2
3
4
5
6
From the SETUP OPTIONS list, click Alert Presets.
From the PRESET OPTIONS list, click Core Hours.
In the CORE HOURS pane, under Days, select the beginning and ending core days from the two lists.
Under Time, do one of the following:
• Select 24 hours to specify the entire day on core days.
• Select the time interval option and select the beginning and ending times from the two lists.
From the Time Zone list, select the time zone to use for the core hours.
Click Apply to apply the settings.
Note: As you make selections in this view, the EVENING HOURS and WEEKEND
HOURS are updated in the view.
Adding and Editing Action Sets
Alert actions can be combined into action sets. An action set allows you to run multiple alert actions in a single operation.
Teradata Viewpoint User Guide 39
Chapter 7 System Administration
Alert Setup
1
2
3
4
5
6
From the SETUP OPTIONS list, click Alert Presets.
From the PRESET OPTIONS list, click Action Sets.
From the ACTION SETS list, do one of the following:
• To add an action set, click .
• To copy an action set, click in the row of the action set you want to copy.
• To edit an action set, click the name of the action set.
In the Action Set Name box, type a name for the action set.
Under Times, select check boxes for the hours of operation during which you want the action set to run.
Under Actions, select any of the following actions by selecting the appropriate check box:
Option Description
Include in alert log
Enables the alert log.
Send to person In the appropriate box, type the recipient name or ID, role, or email address.
Specify multiple users in any box by separating them with a semicolon. You can use the boxes in any combination to specify different recipients.
SNMP
BTEQ
Select the SNMP configuration from the list.
From the lists, select the BTEQ script to run and the TDPID of the Teradata
Database to log on to and against which to run the script.
Note: Select Get from alert to specify the Teradata Database that generated the alert.
Run a program From the list, select the program to run. You have the option to enter commandline arguments.
7
You also have the option to add or remove actions.
Note: The Send to person, SNMP, BTEQ, and Run a program actions are dimmed if they have not been defined by your Teradata Viewpoint Administrator or Teradata
System Administrator. For additional information, see the Teradata Viewpoint
Configuration Guide.
Click Apply to apply the settings.
Adding and Editing Groups
Alert actions can be combined into action sets, and alert action sets can be combined into groups. A group allows you to run multiple action sets in a single operation.
Note: Action sets must be defined before they can be included in a group.
1
2
3
From the SETUP OPTIONS list, click Alert Presets.
From the PRESET OPTIONS list, click Groups.
From the GROUPS list, do one of the following:
40 Teradata Viewpoint User Guide
Chapter 7 System Administration
Alert Setup
4
5
6
• To add a group, click .
• To copy a group, click in the row of the group you want to copy.
• To edit a group, click the name of the group.
In the Group Name box, type a name for the group.
From the list under Include the Following Action Sets, select the action set you want to include in the group.
You also have the option to add or remove action sets.
Click Apply to apply the settings.
Deleting Action Sets or Groups
If you delete a group, the group configuration is lost but the action sets combined in the group remain.
Note: You cannot delete an action set if it is used in a group or an alert rule.
Note: You cannot delete a group if it is used in an alert rule.
1
2
3
4
From the SETUP OPTIONS list, click Alert Presets.
From the PRESET OPTIONS list, click Action Sets or Groups.
From the ACTION SETS or GROUPS list, click to delete a configuration.
A confirmation message appears.
Click OK.
Group Examples
Alert actions can be combined into action sets, and action sets can be combined into groups.
A group allows you to run multiple action sets in a single operation.
Different Alert Actions for Weekday and Weekend Hours
If you want a different set of alert actions to be performed for an event depending on the time period, define time-specific action sets and assign them to a group.
If you want the alert to perform an SNMP notification when a space-usage threshold is exceeded on a weekday, and to perform an SNMP notification and also send an email message to the Teradata Database Administrators when the threshold is exceeded during the weekend, define two action sets: one SNMP notification action for core, evening, and weekend hours, and one email notification action for weekend hours only.
Create a group and assign both action sets to the group. Then, in the Teradata Viewpoint administrative portlet where you want to define the alert, assign the group as the alert action.
Managing Email Alert Recipients
Groups and action sets can also be used to manage alert recipients, similar to email distribution lists.
Define action sets that send email notifications to different sets of people in your organization.
Teradata Viewpoint User Guide 41
Chapter 7 System Administration
Backup
One action set could send an email notification to the Teradata Database Administrators, and another action set could send an email notification to end users in the finance department.
Create a group and assign both action sets to the group. Then, in the Teradata Viewpoint administrative portlet where you want to define the alert, assign the group as the alert action. When an alert is issued, both sets of users receive an email notification.
Backup
Backup
The BACKUP portlet allows you to enable automatic Teradata Viewpoint system backups and configure the data retention settings.
The BACKUP portlet displays the backup process icon with either a successful completion or an error for the last attempt and lists the last successful backup date and time. Use the
BACKUP portlet to:
• Enable and disable the daily backup process
• Store the backup files on the local system or at a network location
• Select the daily backup time
• Select how many days to keep the backup files
About Backup Errors
The BACKUP dialog box displays an out-of-service icon and the status message AN ERROR
HAS OCCURRED if an error occurs during the backup process. To investigate the error, you can view the backup log file:
/opt/teradata/dcs/logs/backup.log
. For additional information, see the Teradata Viewpoint Configuration Guide.
42 Teradata Viewpoint User Guide
Chapter 7 System Administration
LDAP Servers
Scheduling Viewpoint Backups
You can configure automatic backups, set a data retention length, and enable or disable the backup process at any time.
1
2
3
4
5
[Optional] From the BACKUP view, do one of the following:
• Select the Enable backup check box to activate the backup process.
• Clear the Enable backup check box to disable the automatic-backup process.
Under Location, select one of the following options to set the location of the backup files:
• Click Local to use the local server.
• Click Network to use a network location and do the following:
• Enter a Host to specify the host system name.
• Enter a Path to specify the absolute path name where the backups are stored on the host system.
• [Optional] Click Test to verify that the login settings are correct. The icon appears if the operation is successful. The icon appears if the operation fails.
Verify that the settings are correct, and try again.
From the Daily Backup Time list, select the daily start time of the backup operation.
From the Keep Backups For list, select the number of days to retain the backup data.
Click Apply.
The changes are saved and backup files are deleted when they are older than the configured number of days.
LDAP Servers
LDAP Servers
The LDAP SERVERS portlet allows you to configure LDAP servers to authenticate users and assign user roles in Teradata Viewpoint. The LDAP SERVERS portlet displays the names of currently configured LDAP servers or is empty if an LDAP is not configured.
• Use next to SETUPS to add an LDAP server.
• Use the order buttons to adjust the evaluation order of the LDAP-server list.
• Use next to the server name to delete an LDAP server.
• Use the dialog box to enable and disable an LDAP server, and configure the LDAP to automatically validate users against the LDAP directory with the auto-provisioning feature or assign user roles with the role mapping feature.
Teradata Viewpoint User Guide 43
Chapter 7 System Administration
LDAP Servers
44
What is an LDAP Server?
Teradata Viewpoint uses a Lightweight Directory Access Protocol (LDAP) server to:
• Validate new user information by querying the LDAP for authentication. The binding operation authenticates a username and a password.
• Automatically create a Teradata Viewpoint username with the auto-provisioning feature.
• Automatically assign users to a Teradata Viewpoint role with the Role Mapping feature.
Adding an LDAP Server
This task describes how to add an LDAP server to authenticate and assign roles to Teradata
Viewpoint users.
1
2
3
4
5
Click next to SETUPS.
Enter a Nickname for the LDAP server (up to 8 characters).
[Optional] Select the Enabled check box to activate LDAP upon successfully adding the
LDAP server to Teradata Viewpoint.
Enter a URL address.
One URL address is required. Use the evaluation order.
to delete, add, and move up or move down in
Select the Name Matching method from the following options:
• Select DN Pattern Bind to specify one or more patterns that represent a distinguished name (DN) in the LDAP directory.
• Select User Search to search for a pattern in the base directory or subdirectories:
Teradata Viewpoint User Guide
Chapter 7 System Administration
LDAP Servers
6
7
8
9
• [Optional] Enter a Service account DN and Service account password to search with a specific account.
• [Optional] Leave Service account DN and Service account password blank to connect to the LDAP as an anonymous user.
• Enter a Search pattern.
• Enter a Search base to specify a base directory for the search pattern.
• [Optional] Select the Search extent Recursive scan check box to include subdirectories of the base directory in the search.
• [Optional] Under Search extent, clear the Recursive scan check box to limit the search to the specified base directory.
Configure Key User Information:
• Enter the LDAP first name attribute.
• Enter the LDAP last name attribute.
• Enter the LDAP email attribute.
Note: Every user has an email address. This default email domain is used if a valid email address is not found in the LDAP directory during auto-provisioning.
[Optional] Test your settings: a b
Click Test to display the LDAP test panel.
Enter a Test username and Test password.
c
Click Run.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
[Optional] Configure Auto-Provisioning: a b
[Optional] Select the Turn on auto-provisioning check box to automatically validate users against the LDAP directory.
Select a role from the Automatically assign these roles menu. You can add or remove roles.
c
Enter a Default email domain to provide a notification email address.
Note: Every user has an email address. This default email domain is used if a valid email address is not found in the LDAP directory during auto-provisioning.
If the group role mapping method is specified, configure Role Mapping: a b c d
Enter a Group search base.
[Optional] Select the Group search subtree check box to include subtree directories during the binding process.
Enter a Group attribute name.
[Optional] Click Add Role Mapping to add attribute or group settings so that you can assign another role.
Teradata Viewpoint User Guide 45
Chapter 7 System Administration
LDAP Servers
10
Click Apply.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
About Role Mapping
In Teradata Viewpoint, users are assigned roles to organize and control their access to portlets, metrics, and features. You can use the ROLES MANAGER portlet to assign permissions to the roles. During the process of adding an LDAP configuration to Teradata
Viewpoint, the optional Role Mapping section in the LDAP Servers portlet allows you to assign a role automatically to auto-provisioned users.
Use role mapping to:
• Assign roles for a new user.
• Add roles that were assigned to the user since the last user login.
• Remove roles that were removed since the last user login.
Consider the following:
• Only roles already defined using the ROLES MANAGER portlet can be mapped.
• A Teradata Viewpoint Administrator can change a role at any time using the ROLES
MANAGER portlet.
Role Mapping Use Cases
In the following use cases, the LDAP value represents the distinguished name (DN) of a group. When the Type is Attribute, the attribute name field represents the user attribute where the group DN is stored. When the Type is Group, the group attribute name field is used for mapping and represents the group attribute where the user DN is stored.
The first use case assigns users to a Teradata Viewpoint role based on an attribute of the user's record in LDAP. Assume you have a user with the following record in LDAP: dn: cn=User1,ou=Users,dc=teradata,dc=com memberOf: cn=USA,ou=Groups,dc=teradata,dc=com
In this case, the Group attribute name field is not relevant. To map User1 to the Teradata
Viewpoint role US Users, create the following role mapping:
• Type = Attribute
• Attribute name = memberOf
• LDAP value = cn=USA,ou=Groups,dc=teradata,dc=com
• Viewpoint role = US Users
The second use case assigns users to a Teradata Viewpoint role based on membership in an LDAP group with the following structure: dn: cn=DBAs,ou=Groups,dc=teradata,dc=com uniqueMember: cn=User2,ou=Users,dc=teradata,dc=com
In this case, set the Group attribute name field to uniqueMember. To map User2 to the
Teradata Viewpoint role DBAs, create the following role mapping:
• Type = Group
46 Teradata Viewpoint User Guide
Chapter 7 System Administration
Managed Servers
• LDAP value = cn=DBAs,ou=Groups,dc=teradata,dc=com
• Viewpoint role = DBAs
Managed Servers
Managed Servers
A managed server is a server in a Teradata cabinet that is monitored by the same Teradata server management solution used to monitor TPA nodes. A managed server might be used for storage, backup, or housing data collectors that provide portlet information and metric data. Teradata Viewpoint monitors managed servers for system-level metrics and collects information for Teradata Viewpoint portlets.
The MANAGED SERVERS portlet displays the names of currently configured managed servers or is empty if no managed server is configured. Use next to SERVERS to add a managed server. Use the dialog box to delete, enable, and disable a managed server for use by the Teradata Viewpoint Data Collection Service (DCS).
Adding a Managed Server
This task describes how to add a managed server to Teradata Viewpoint. After a managed server is defined in Teradata Viewpoint, you can test the configuration settings and enable the managed server for use by the Data Collection Service (DCS).
1
2
3
Click next to SERVERS.
[Optional] Select the Server enabled check box to activate the managed server for the DCS.
Enter values for these required fields:
• Managed Server Name is an 8-character alphanumeric name.
• Hostname is the managed server IP address or domain name.
• Login is the user name and password.
Teradata Viewpoint User Guide 47
Chapter 7 System Administration
Portlet Library
4
Note: The default values only need to be changed if you change the login and password settings during the installation of TMS Monitor.
Do any of the following:
• Click Test to verify that the login settings are correct.
• Click Apply to update the managed server.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again. If you are unable to enable or disable the managed server, contact your Teradata Viewpoint Administrator.
Deleting a Managed Server
This task describes how to delete a Teradata Viewpoint managed server. This is a permanent procedure that differs from disabling the managed server from the Data Collection Service.
1
2
3
From the SERVERS list, click on the managed server name you want to remove.
In the dialog box, click Delete Server.
A confirmation message appears.
Click OK.
Enabling or Disabling a Managed Server
After a managed server is defined in Teradata Viewpoint, you can enable it for use by the
Data Collection Service (DCS) or disable it.
1
2
3
From the SERVERS list, click on the managed server name you want to update.
Do one of the following:
• Select the Server enabled check box to activate a managed server.
• Clear the Server enabled check box to disable a managed server.
Note: When disabled, the DCS does not use the managed server. Any existing data about the managed server can still be viewed.
Do any of the following:
• Click Test to verify that the login settings are correct.
• Click Apply to update the managed server.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again. If you are unable to enable or disable the managed server, contact the Teradata Viewpoint Administrator.
Portlet Library
Portlet Library
The Portlet Library allows you to enable or disable portlets globally. This setting takes precedence over every other portlet permission level.
48 Teradata Viewpoint User Guide
Chapter 7 System Administration
Portlet Library
The Manage Existing Portlets view allows you to manage the installed portlets, which are grouped by category. Details about each portlet are also provided:
• Version number
• Publisher name
• Bundle name
• Installation date
• Whether the portlet is enabled
Note: Portlets in the Admin category display N/A in the ENABLE column. These portlets cannot be disabled and are included in the view only to provide version information.
Enabling or Disabling Portlets
Teradata Viewpoint Administrators can use the Portlet Library to enable or disable installed portlets for Teradata Viewpoint user access.
1
2
3
In the Manage Existing Portlets dialog box, click a name to expand a category.
For each installed portlet, do one of the following:
• Enable the portlet by selecting the corresponding check box.
• Disable the portlet by clearing the corresponding check box.
You can enable all the portlets by clicking the ENABLE column heading. Portlets in the
Admin category display N/A in the ENABLE column. These portlets cannot be disabled and are included in the view only to provide version information.
Click Apply.
Deleting a Shared Portlet
Teradata Viewpoint Administrators can use the Portlet Library to delete a shared portlet so
Teradata Viewpoint users can no longer access it.
Teradata Viewpoint User Guide 49
Chapter 7 System Administration
Roles Manager
1
2
3
In the Manage Existing Portlets dialog box, click Shared to expand the category.
Click under the DELETE column that corresponds to the shared portlet you want to delete.
A confirmation message appears.
Click OK.
The portlet name no longer appears in the Add Content menu in the portal, and the portlet is no longer available to Teradata Viewpoint users. Existing instances of a shared portlet on a portal page remain on the page. However, a warning message appears if a user tries to access the portlet.
Roles Manager
Roles Manager
The Roles Manager portlet allows Teradata Viewpoint Administrators to assign permissions efficiently by creating classes of users called roles.
Teradata Viewpoint Administrators can perform the following tasks:
• Add and configure new roles
• Edit the configuration and settings of existing and default roles
• Copy roles, saving time in creating new roles
• Enable or disable portlets for a role.
• Delete roles that are no longer needed
About Roles
Teradata Viewpoint includes the following preconfigured roles:
Administrator This role has all permissions and can be assigned to any account. It is recommended that this role be used only by Teradata Viewpoint
Administrators.
User This role is assigned to every Teradata Viewpoint user and cannot be removed from Teradata Viewpoint. It is recommended that this role be set with minimum user permissions.
It is recommended that you configure new roles with partial permissions that are appropriate to all users in that role. Each role you create controls access to specific systems, portlets, metrics, preferences, and permissions in portlets.
Example Roles
The following examples show how roles can be defined to manage portlet usage and control permissions within Teradata Viewpoint.
50 Teradata Viewpoint User Guide
Chapter 7 System Administration
Roles Manager
AppDBA
The AppDBA role is defined for users that are application DBAs. The rewind feature and some portlets are enabled for this role so users can review graphs in the
PRODUCTIVITY portlet.
AcctDept
The AcctDept role is defined for all users in the Accounting Department. Some portlets are enabled for this role. These users are granted permissions so they can edit all calendar events in the CALENDAR portlet and access the MY QUERIES portlet to monitor their queries.
OpDBA
The OpDBA role is defined for users that are operations DBAs. The rewind feature and all portlets are enabled for this role so users can monitor performance trends. Users in the
OpDBA role access the WORKLOAD MONITOR portlet to track Teradata Database request arrivals and completions.
About the Roles Manager View
The Roles Manager view allows Teradata Viewpoint Administrators to manage roles efficiently, including assigning users to roles, and granting user permissions. After a role is created, you can customize the role using the following tabs:
General
Users
Enable or disable a role, and select the systems available to that role.
Search for users and add them to, or remove them from, the list of users assigned to the selected role.
Portlets Enable or disable portlets for a role. This tab can also be used to configure default settings per portlet, per role.
Metrics Select the metrics to display per metric, per system.
Permissions Configure permissions per system, per portlet, per role.
A hierarchy of permissions controls portlet behavior according to role. In order of precedence, permissions are configured on the Portlets tab, the General tab, and the
Permissions tab.
Note: Use the Portlet Library portlet to globally enable and disable access to portlets.
Adding a Role
This task describes how to add a role and assign one or more Teradata Database systems to the role.
1
From the Roles Manager view, click Add Role.
An Add role dialog box appears with the General tab selected (default).
Teradata Viewpoint User Guide 51
Chapter 7 System Administration
Roles Manager
52
2
3
4
5
6
Under Name, enter a new name for the role, up to 25 characters.
You can use alphanumeric characters and underscore (_), but no space.
Under Description, use the default or enter a new description, up to 255 characters.
[Optional] Under Role State, do one of the following:
• Leave the Role State as is.
• Select Enabled to enable the role for configuration and adding users, and activate the role for use with Teradata Viewpoint.
• Select Disabled to enable the role for configuration and adding users, but disable the role for use with Teradata Viewpoint.
[Optional] Under Rewind State, do one of the following:
• Leave the Rewind State as is.
• Select Enabled to grant permission to this role to use the rewind feature, when available.
• Select Disabled to deny permission for this role to use the rewind feature.
[Optional] Under Enable Systems For Role, do one of the following:
• Leave the currently selected Teradata Database systems as is.
• Select new Teradata Database systems the selected role is authorized to access.
• Click the Enable Systems For Role column heading to select all check boxes for the
Teradata Database systems.
Note: You can click the column heading again to clear all check boxes.
Editing a Role
This task describes how to edit a role. You cannot change the name of an existing role. To change the name, you must either add a new role or copy the role, and then change the role name.
1
From the Roles Manager view, select a role from the list.
A dialog box appears with the current information for the selected role.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Roles Manager
2
3
4
5
Under Description, use the default or enter a new description, up to 255 characters.
[Optional] Under Role State, do one of the following:
• Leave the Role State as is.
• Select Enabled to enable the role for configuration and adding users, and activate the role for use with Teradata Viewpoint.
• Select Disabled to enable the role for configuration and adding users, but disable the role for use with Teradata Viewpoint.
[Optional] Under Rewind State, do one of the following:
• Leave the Rewind State as is.
• Select Enabled to grant permission to this role to use the rewind feature, when available.
• Select Disabled to deny permission for this role to use the rewind feature.
[Optional] Under Enable Systems For Role, do one of the following:
• Leave the currently selected Teradata Database systems as is.
• Select new Teradata Database systems the selected role is authorized to access.
• Click the Enable Systems For Role column heading to select all check boxes for the
Teradata Database systems.
Note: You can click the column heading again to clear all check boxes.
Copying a Role
When a role is copied, all settings on all tabs are inherited from the original role, except for the Name field on the General tab. When the Administrator role is copied, all information on all tabs is copied. However, the copied role does not have administrative privileges and does not have an Admin menu on the portal.
1
2
From the Roles Manager view, select a role from the list.
Click Copy Role.
A dialog box appears with the General tab selected.
Teradata Viewpoint User Guide 53
Chapter 7 System Administration
Roles Manager
54
3
4
5
6
7
Under Name, enter a new name for the role, up to 25 characters.
You can use alphanumeric characters and underscore (_), but no space.
Under Description, use the default or enter a new description, up to 255 characters.
[Optional] Under Role State, do one of the following:
• Leave the Role State as is.
• Select Enabled to enable the role for configuration and adding users, and activate the role for use with Teradata Viewpoint.
• Select Disabled to enable the role for configuration and adding users, but disable the role for use with Teradata Viewpoint.
[Optional] Under Rewind State, do one of the following:
• Leave the Rewind State as is.
• Select Enabled to grant permission to this role to use the rewind feature, when available.
• Select Disabled to deny permission for this role to use the rewind feature.
[Optional] Under Enable Systems For Role, do one of the following:
• Leave the currently selected Teradata Database systems as is.
• Select new Teradata Database systems the selected role is authorized to access.
• Click the Enable Systems For Role column heading to select all check boxes for the
Teradata Database systems.
Note: You can click the column heading again to clear all check boxes.
Deleting a Role
This task describes how to delete a role. After a role is deleted, it cannot be restored. This action affects all users assigned to the role.
1
2
From the Roles Manager view, select a role from the list.
Click Delete Role.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Roles Manager
3
A confirmation message appears.
Click OK.
The deleted role is removed from the list.
Assigning Users to a Role
This topic describes how to search for users and assign them to a role.
Note: If auto-provisioning is in use, a default role is automatically assigned to new users the first time they log on. User is generally the default assignment.
1
2
3
From the Roles Manager view, select a role from the list.
Click the Users tab.
The users list appears and includes two panes. The left pane lists all Teradata Viewpoint system users. The right pane lists users already assigned to the selected role. In the left pane, the names of users already assigned to the selected role are dimmed.
[Optional] Search for a user: a
Select a filter from the list.
4
5
6 b
In the contains field, enter the search criteria.
c
Click Find.
The AVAILABLE USERS list displays only users meeting the search criteria.
Select one or more users from the left pane.
Note: You can select multiple users by holding the CTRL key and clicking additional names.
Click .
The selected users are assigned to the role. Selected user names are copied to the right pane and are dimmed in the left pane.
Click Apply.
Removing Users from a Role
This topic describes how to remove users from a role.
1
2
From the Roles Manager view, select a role from the list.
Click the Users tab.
Teradata Viewpoint User Guide 55
Chapter 7 System Administration
Roles Manager
The users list appears and includes two panes. The left pane lists all Teradata Viewpoint system users. The right pane lists users already assigned to the selected role. In the left pane, the names of users already assigned to the selected role are dimmed.
56
3
4
5
Select one or more users from the right pane.
Note: You can select multiple users by holding the CRTL key and clicking additional names.
Click .
The selected users are removed from the role. The names no longer appear in the right pane and are no longer dimmed in the left pane.
Click Apply.
Enabling Portlets for a Role
This task describes how to enable Teradata Viewpoint portlets for a role. Portlets enabled using the Roles Manager portlet are the default portlets available for all users assigned to the selected role.
1
2
From the Roles Manager view, select a role from the list.
Click the Portlets tab.
A dialog box appears displaying the portlet categories.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Roles Manager
3
4
5
Click a name to expand a category and display the available portlets.
For the selected role, select the portlets to enable in each category.
Click the ENABLE FOR ROLE column heading to enable the role for all portlets. Click the column heading again to clear all check boxes. Enabling a portlet in the Roles
Manager view, Portlets tab, includes the portlet in the Teradata Viewpoint Add
Content menu for all role-assigned users.
Click Apply.
Configuring Default Portlet Settings
This topic describes how to configure default portlet settings for a role.
Note: Shared portlets are preconfigured using an instance of a portlet and cannot be configured using the Roles Manager portlet.
1
2
From the Roles Manager view, select a role from the list.
Click the Portlets tab.
A dialog box appears displaying the portlet categories.
Teradata Viewpoint User Guide 57
Chapter 7 System Administration
Roles Manager
58
3
4
5
Click a name to expand a category and display the available portlets.
Configure defaults for each portlet as follows: a Click for the portlet you want to configure.
The CONFIG view for the corresponding portlet appears.
Note: Configuration defaults entered in the CONFIG view only apply to the role being configured. If a user is assigned to multiple roles, the role with the highest priority determines which settings are applied to every instance of the portlet added to a portal page. For example, if a user is assigned the roles of Administrator then
User, the Administrator settings apply to each instance of the portlet. Also, Teradata
Viewpoint Administrators can grant users permission to set preferences for a subset of the available settings as long as user preferences are not disabled.
b
Follow the instructions in the preferences-related topics provided for each portlet in
Teradata Viewpoint Help.
Click Apply.
Granting Metric Permissions for a Role
This topic describes how to grant permissions for metrics by role. The metric permissions granted to a role apply to the following portlets only:
• CAPACITY HEATMAP
Teradata Viewpoint User Guide
Chapter 7 System Administration
Roles Manager
• METRICS ANALYSIS
• METRICS GRAPH
• TODAYS STATISTICS
1
2
From the Roles Manager view, select a role from the list.
Click the Metrics tab.
A dialog box appears displaying the metrics categories and each Teradata Database system name.
3
4
Select the metrics for each available Teradata Database system that you want users in the selected role to see by doing any of the following:
• Click Select All to select every option on every system.
Select All becomes Clear All.
• Click Clear All to deselect every option on every system.
Clear All becomes Select All.
• Click the top check box in a column to select or clear all check boxes for a category for all systems.
• Click the system name at the left of the row to select or clear all check boxes for that system.
• Click a check box to select or clear that category for that system.
Click Apply.
Granting Portlet Permissions for a Role
This topic describes how to enable specific features of a portlet by system and role.
1
2
3
From the Roles Manager view, select a role from the list.
Click the Permissions tab.
Select a portlet from the Select portlet list.
The Permissions dialog box displays a list of the available systems and options.
Teradata Viewpoint User Guide 59
Chapter 7 System Administration
Teradata Systems
4
5
Select the permissions you want to grant to the selected role for each available Teradata
Database system by doing any of the following:
• Select the SET PREFS check box to allow users to set their own preferences.
• Select the SHARE PORTLET check box to allow users to share customized versions of the portlet with other users.
• Click Select All to select every option on every system.
Select All becomes Clear All.
• Click Clear All to deselect every option on every system.
Clear All becomes Select All.
• Click the top check box in a column to select or clear all check boxes for a category for all systems.
• Click the system name at the left of the row to select or clear all check boxes for that system.
• Click a check box to select or clear that category for that system.
Click Apply.
Teradata Systems
Teradata Systems
The TERADATA SYSTEMS portlet allows Teradata Viewpoint Administrators to add, configure, enable, and disable Teradata Database systems using specific dialog boxes:
60 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
General Configure the system nickname, TDPID, login names, passwords
(hidden), and account strings (optional). Test the connection to Teradata
Database, and add or delete login names.
Canary Queries Configure canary queries used to test Teradata Database system response times. The SYSTEM HEARTBEAT canary query cannot be removed.
System Health Enable metrics for the SYSTEM HEALTH portlet. Configure degraded and critical thresholds for each metric.
Alerts Add, delete, copy, and configure alerts, or migrate existing Terdata
Manager alerts.
Data Collectors Enable, disable, and configure data collectors to capture and retain portlet, disk usage, and resource data.
Monitor Rates Set Teradata Database internal sample rates for sessions, node logging, and vproc logging.
You can view the amount of disk space used:
Disk usage View the percentage of total disk space being consumed by collected data on the managed server.
Twelve hour change
View the percentage of disk space used or has become available over the past twelve hours. Positive indicates the amount of space used has increased. Negative indicates the amount of space used has decreased.
Adding a Teradata Database System
This task describes how to add a Teradata Database System to Teradata Viewpoint. The system must be added before you can configure the data collectors to monitor the database.
1
Click next to SYSTEMS.
Teradata Viewpoint User Guide 61
Chapter 7 System Administration
Teradata Systems
62
2
3
4
5
6
7
8
Enter a SYSTEM NICKNAME (up to 8 characters).
[Optional] Select the System Enabled check box to activate the Teradata Database system for monitoring.
Enter the TDPID of the Teradata Database system.
Enter a LOGIN name and password.
You also have the option to specify an account string, add more logins, and test that the login settings are correct.
[Optional] In the COLLECTORS section, select the Enable all Data Collectors
(Configure in DATA COLLECTORS) check box to activate the data collectors.
[Optional] In the CHARACTER SET section, set the session and monitor default character sets, or enable a JDBC Flag.
• [Optional] Select a character set from the Session menu.
• [Optional] Select a character set from the Monitor menu.
• [Optional] To enable the JDBC Flag field, set Session and Monitor to ASCII and enter a JDBC Flag value.
Click Apply to apply the settings.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
Deleting a Teradata Database System
Deleting a Teradata Database system removes the system from Teradata Viewpoint and removes all data collector and canary query information.
1
From the SYSTEMS list, click the Teradata Database system name you want to update.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
2
3
4
From the SETUP list, click General.
Click Delete System.
A confirmation message appears.
Click OK.
Adding a Login Account
After a Teradata System has been configured in Teradata Viewpoint, an unlimited number of login accounts can be added and referenced on other TERADATA SYSTEMS portlet views.
1
2
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click General.
3 Under LOGIN, click .
4
5
A blank row appears.
Enter a LOGIN name and password.
You also have the option to specify an account string, add more logins, and test that the login settings are correct.
Click Apply to apply the settings.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
Deleting a Login Account
At least one login account must be configured for a Teradata Database system. You cannot remove the last login account.
1
2
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click General.
3 Under LOGIN, click on the login row to be removed.
Teradata Viewpoint User Guide 63
Chapter 7 System Administration
Teradata Systems
The row disappears. The login is removed permanently.
CHARACTER
SET Fields
Session
Standard Character Set Configurations
When you configure a Teradata Database system, the CHARACTER SET section of the
GENERAL setup allows you define the charset that the system uses to communicate with
Teradata Viewpoint. The character set definitions are optional. If you do not define them,
Teradata Viewpoint uses the Teradata Database system settings.
Character Set Definition Suggestions
Monitor
JDBC Flag
The UTF8 session character set is strongly recommended for the Teradata Viewpoint session to ensure end-to-end fidelity of character data by avoiding conversion between character sets. However, the UTF8 session character set does not support the KANJI1 server character sets, which are used for storing data dictionary data in Teradata V2R6.x Japanese systems. For these systems, Japanese users must specify the
Kanji session character set.
The UNICODE session character set is not currently supported for the Teradata Performance Monitor and Console Partition. To create Teradata Viewpoint object names that connect Monitor and Console
Partitions, use Non-Unicode session character sets such as LATIN1252_0A, KANJISJIS_OS, and
KANJIEUC_OU.
To set the JDBC Flag, you must set the session character set and the monitor character set to ASCII. The
JDBC Flag setting is a legacy-support feature to assist the transition away from the unsupported use of the Teradata Database to store non-Latin characters in a Latin column, and the unsupported access of non-ASCII in an ASCII session character set. The JDBC Flag option specifies the CLIENT_CHARSET connection parameter, which can be used to override the Teradata JDBC Driver fixed-mapping of the
Teradata session character set to the Java character set. The valid values are the actual Java character set names. Here are two examples of valid JDBC Flag settings:
• Windows-936 from Chinese (PRC)
• Windows-950 for Chinese (Taiwan)
Teradata
Database
Version
V12.00 and later
V12.00 and later
V2R6.x
Standard
V2R6.x
Language Support
Mode
Standard
Japanese
The following table lists the default Teradata Database system settings.
Data Dictionary
Charset
UNICODE
UNICODE
Teradata
Viewpoint Session
Charset
UTF8
UTF8
Teradata
Viewpoint
Monitor Charset Limitations
ASCII or
LATIN1252_0A
ASCII session only supports the limited 7-bit
ASCII characters
KANJISJIS_OS Unknown
Japanese
LATIN
KANJI1
UTF8
KANJISJIS_OS or
KANJIEUC_OU
ASCII or
LATIN1252_0A
KANJISJIS_OS or
KANJIEUC_OU
Unknown
Use either KANJISJIS_OS or KANJIEUC_OU, for both settings. Do not mix character sets.
64 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
Configuring Data Collectors
After a Teradata System has been configured in Teradata Viewpoint, data collectors can be configured to monitor the database.
1
2
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Data Collectors.
3
4
5
6
7
8
Click the data collector name you want to configure.
[Optional] Select the Enable <data collector name> check box to enable the data collector to begin processing data.
Under LOGIN, select the login you want to configure from the list.
Under SAMPLE RATE, select one of the following options:
• Recommended sample rate. The recommended sample rate is different for each data collector.
• Custom sample rate. The recommended sample rate appears, and you can adjust it to your system requirements.
[Sessions Data Collector only] Under SQL and Explain Thresholds, set the Elapsed
seconds and Total CPU seconds to determine whether the SQL and Explain text is collected for the session.
[Sessions Data Collector only] [Optional] Under New priority for lower priority
action, type one of the following:
•
$L
for low (default)
•
$M
for medium
•
$H
for high
•
$R
for rush
Teradata Viewpoint User Guide 65
Chapter 7 System Administration
Teradata Systems
9
10
When the Lower Priority action executes for an alert, the session that met the alert rules has its priority changed to the above value.
Under DELETE DATA, do any of the following:
• Select the After check box to set the retention period using a number and calendar value.
• Select the Over check box, and then set the file size restriction using the Over box and list.
Click Apply to apply the settings.
Data Collector Rates
Teradata Viewpoint uses a sample rate to collect data from the Teradata Database system and uses a default retention rate to keep the collected data for a time period or up to a certain size. The sample rate and retention rate vary for each data collector and can be adjusted as needed.
Alert Request has no retention rate because this data collector does not store data.
Data Collector Name Recommended Sample Rate
Account Info
Alert Request
AWT Info
Database Space
Disk Space
Lock Info
Query Count
Resource Usage
Sessions
System Stats
Table Space
TASM Config
12 hours
5 minutes
30 seconds
1 day
1 hour
1 hour
DBQLFlushRate value from the
DBS Control utility display command
Teradata Database logging sample rate from Teradata Performance
Monitor (PMON)
Teradata Database session sample rate from PMON
Teradata Database resource sample rate from PMON
1 day
10 minutes
Initial Sample
Rate
12 hours
5 minutes
30 seconds
1 day
1 hour
1 hour
1 Hour
1 hour
30 seconds
30 seconds
1 day
10 minutes
Initial
Retention Rate
1 week
Not applicable
1 year
10 GB
1 year
10 GB
10 GB
10 GB
10 GB
1 year
TASM Distribution
TASM Exception
TASM State
60 seconds
60 seconds
60 seconds
60 seconds
60 seconds
60 seconds
10 GB
Manually deleted, as needed
1 year
1 year
1 year
66 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
Data Collector Name Recommended Sample Rate
TASM Summary 60 seconds
Initial Sample
Rate
60 seconds
Initial
Retention Rate
1 year
Data Collector Catalog
Data collectors gather information from different sources and make the data available to
Teradata Viewpoint portlets.
Data Collector
Name
Description
Account Info Collects and retains available account strings from the
DBC.AccountInfo table. The Queries portlets use this data for the Change Priority function.
Alert Request Monitors the dbcmngr.AlertRequest and dbcmngr.MonitorRequest tables on the Teradata Database system and collects data for for further action by Teradata alerts.
AWT Info Collects AMP worker task (AWT) related information through the AMP Load (ampload) Teradata Database utility.
Canary Queries Executes and retains user-defined canary queries and the System
Heartbeat canary query, which checks the responsiveness of a
Teradata Database system. This data is required for system health metrics.
Database Space Collects and retains database-space metrics from the
DBC.DataBaseSpace and DBC.DBase tables.
Portlets Displaying Data
MY QUERIES, QUERY MONITOR
ALERT VIEWER
CAPACITY HEATMAP, METRICS
ANALYSIS, METRICS GRAPH,
SYSTEM HEALTH
CANARY RESPONSE TIMES,
PRODUCTIVITY, SYSTEM HEALTH
CAPACITY HEATMAP, METRICS
GRAPH, SPACE USAGE, SYSTEM
HEALTH
CAPACITY HEATMAP, METRICS
GRAPH, SYSTEM HEALTH
LOCK VIEWER
Disk Space
Lock Info
Collects and retains disk-space and database-space metrics from the DiskSpace view of the DBC database.
Collects and retains snapshots of lock information from Locking
Logger, a Teradata Database utility.
Query Count Collects and retains Teradata Database query counts and DBQL query log data recorded for each login from the tables
DBC.DBQLogTbl and DBC.DBQLSummaryTbl.
Resource Usage Collects and retains node and vproc resource usage data from the DC.ResUsageSPMA table for node data and
DC.ResUsageIPMA table for vproc data.
Sessions Collects and retains Teradata Database session snapshots for each login from the Teradata Monitor partition by using the
Teradata Performance Monitor API.
System Stats Collects and retains system, node, and vproc statistics information from a Teradata Database. System statistics data is collected from the Teradata Monitor partition by using the PM/
API. Physical and virtual resource statistics are collected from
Teradata Database system memory. For Teradata Database
CAPACITY HEATMAP,
PRODUCTIVITY, TODAYS
STATISTICS, METRICS GRAPH
METRICS ANALYSIS
CAPACITY HEATMAP, METRICS
GRAPH, MY QUERIES, QUERY
MONITOR, SQL SCRATCHPAD,
SYSTEM HEALTH, TODAYS
STATISTICS, WORKLOAD MONITOR
SYSTEM HEALTH, CAPACITY
HEATMAP, METRICS ANALYSIS,
METRICS GRAPH, NODE
Teradata Viewpoint User Guide 67
Chapter 7 System Administration
Teradata Systems
Data Collector
Name
Table Space
TASM Config Collects and retains all rule set information from the tdwm
TASM
Distribution
Description systems earlier than Version 12.00, the System Statistics collector executes awtmon -s through the Teradata Console partition to collect AMP Worker Task (AWT) usage on MP-RAS systems.
AWT usage data is not available on Windows and Linux systems. For Teradata Database Version 12.00 systems and later, the System Statistics collector queries the Teradata Monitor partition to collect AWT usage information.
Collects and retains data about the space used by Teradata
Database system tables from the DBC.Dbase, DBC.TVM,
DBC.Indexes, and DBC.DataBaseSpace tables.
database.
Portlets Displaying Data
RESOURCES, TODAYS STATISTICS,
WORKLOAD HEALTH, WORKLOAD
MONITOR
CAPACITY HEATMAP, METRICS
GRAPH, SPACE USAGE, SYSTEM
HEALTH
MY QUERIES, QUERY MONITOR,
WORKLOAD HEALTH, WORKLOAD
MONITOR
WORKLOAD MONITOR The TASM Distribution data collector collects information about the average percentage of CPU consumption used by each workload for each node in the Teradata Database system. This information is collected by executing schmon -M -p -P through the Teradata Console partition. This data is used by the
WORKLOAD MONITOR portlet to produce the CPU
Consumption pie chart graph in the Distribution view.
Collects and retains data from the DBC exception log.
WORKLOAD MONITOR TASM
Exception
TASM State
TASM
Summary
Collects and retains system regulation data for Teradata
Database Version 12.00 and later. For Teradata Database systems earlier than Version 12.00, the Workload State collector gathers and retains period information.
WORKLOAD MONITOR
Collects and retains active workload data from the tdwm database. WORKLOAD HEALTH, WORKLOAD
MONITOR
About Data Collector Status
The TERADATA SYSTEMS portlet displays an icon when a data collector is disabled or functioning with errors. To see the most current status, it is recommended to refresh the system list and the data collector dialog box. You can view the icons in the system and data collector lists:
Error Appears next to a Teradata Database system name or data collector name when one of these errors has been detected:
• Processing exception
• Incorrect Teradata System privileges
• Configuration errors, such as an incorrect password
• Teradata System is offline
Disabled Appears next to a Teradata Database system name or data collector name if it is currently disabled.
68 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
Viewing an Error Log
1
2
3
4
From the SYSTEMS list, click the Teradata Database system whose name is followed by
.
From the SETUP list, click Data Collectors.
The DATA COLLECTORS list refreshes the condition of each collector, identifying the collector that has the error.
Click next to the collector name of the log you want to view.
The Java stack trace log appears.
Click Close.
Configuring System Health Values
The System Health setup configures metrics and thresholds that are used by the SYSTEM
HEALTH and PRODUCTIVITY portlets. These thresholds are settings for the data collected by the System Statistics, Sessions, Disk Space, and Canary Queries Collectors.
1
2
From the SYSTEMS list, click the Teradata Database system name.
From the SETUP list, click System Health.
The System Health dialog box appears.
3
4
5
For each metric, select one of the following options:
• Click Enabled to make the metric visible and use the threshold values to determine the system status.
• Click Disabled to ignore the metric and the threshold values.
• Click View Only to make the metric visible but to ignore the threshold values.
For each metric, adjust the degraded or critical thresholds.
Click Apply.
System Health Metrics
The following table lists the metrics that you can specify in the System Health dialog box.
Teradata Viewpoint User Guide 69
Chapter 7 System Administration
Teradata Systems
Metric
CPU
UTILIZATION
(CPU) USER
Description
Total average node CPU usage
Average percentage of CPU time spent in User Mode
(CPU) SYSTEM Average percentage of CPU time spent in System (Kernel) Mode
(CPU) IO WAIT Average percentage of CPU time spent waiting for I/O
Type
Percent
Percent
Percent
Percent
NODE CPU
SKEW
Comparison of CPU utilization on the busiest node to the average node Percent
NODE IO SKEW Comparison of disk utilization on the busiest node to the average node Percent
AMP CPU SKEW Comparison of CPU utilization on the busiest AMP to the average AMP Percent
AMP IO SKEW Comparison of disk utilization on the busiest AMP to the average AMP Percent
Average number of AMP Worker Tasks in use on each AMP Number AMP WORKER
TASKS
TOTAL DISK
SPACE
Percentage of total disk space currently in use Percent
Percent MAX DISK BY
AMP
COMPONENT
DOWN
Percentage of available disk space currently in use
Number of components that are currently offline (such as BYNETs,
AMPs)
MEMORY USED Average amount of memory currently in use on each node (MB)
MAX SPOOL BY
AMP
Percentage of available spool space in use
Number
Number
Percent
Number MEMORY
FAILURES
Total number of memory failures across all nodes
DBC DISK SPACE Percentage of available DBC disk space in use
Number of sessions with active queries ACTIVE
SESSIONS
SYSTEM
HEARTBEAT
Response time of the most recent system heartbeat query (ms)
SYSTEM
HEARTBEAT
COPY
Response time of the secondary system heartbeat query (ms)
Percent
Number
Number
Number
Adding or Copying a Canary Query
After a Teradata System has been configured in Teradata Viewpoint, a canary query can be added to check the state of the system. If the system is active, the query returns a result.
1
2
3
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Canary Queries.
Do one of the following:
70 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
• To add a canary query, click .
• To copy a canary query, click in the row of the canary query you want to copy.
The canary query dialog box appears.
4
5
6
7
8
9
10
11
Enter a name for the canary query.
[Optional] Select the Enabled check box to enable the canary query.
Under SQL, enter or modify the query SQL code.
Under DEFAULT DATABASE, specify the default database.
Under LOGIN, select the login you want to configure from the list.
Under COLLECT DATA, specify the data collection frequency in seconds.
The recommended sample rate is 120 seconds. The retention rate is one year.
Under EXECUTE, select one of the following options:
• Click 24/7 to execute the query 24 hours a day, 7 days a week.
• Click Custom to execute the query during a time range by specifying the start time, end time, start day, and end day.
Under DELETE DATA, do any of the following:
• Select the After check box to set the retention period using a number and calendar value.
Teradata Viewpoint User Guide 71
Chapter 7 System Administration
Teradata Systems
12
• Select the Over check box, and then set the file size restriction using the Over box and list.
Click Apply to apply the settings.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
Deleting a Canary Query
SYSTEM HEARTBEAT is a canary query that cannot be deleted. It is used to check whether the Teradata Database system is responsive.
1
2
3
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Canary Queries.
Click in the row of the canary query you want to delete.
72
4
A confirmation message appears.
Click OK.
The canary query row disappears.
About Alerts
Alerts monitor the performance on a Teradata Database system and automatically take action when events occur. You can add, copy, and configure alerts, as well as migrate
Teradata Manager alerts.
You can activate alert actions that send a notification, or take some other type of action, when a metric exceeds a threshold.
After you add alert action sets in the ALERT SETUP portlet, they appear in the
TERADATA SYSTEMS portlet.
The types of alert actions you can choose are:
Send an Email Choose a defined email address and text message. Event information, such as date, time, event name, threshold, and actual value, is automatically added to the body of the email message.
Run a Program Choose a program to execute (.exe).
Run a BTEQ Script Choose a BTEQ script.
Notify SNMP System Choose an SNMP trap.
You can also choose alert actions for sessions including:
<Abort
Session>
Abort the Teradata Database session for which an alert was detected. This action is only available for sessions.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
<Lower
Priority>
Set the priority of the Teradata Database session for which an alert was detected to the one specified in the New priority for lower priority action text box, located under Data Collectors setup for Sessions.
Alert Types
You can set alerts that take place when performance or database space events occur on one or more Teradata Database systems. Following is a list of alert types.
Alert Type
System
Node
Vproc
Database Space
Session
Canary Queries
System Health
Description
Set an alert to occur when the performance on a Teradata Database reaches the specified threshold.
Set an alert to occur when the performance on a Teradata Database reaches the specified threshold at the node level.
Set an alert to occur when the performance on a Teradata Database reaches the specified threshold at the vproc level.
Set an alert to occur when the space used on any resource, such as an AMP, exceeds the specified percentage.
Set an alert to occur when the performance on a Teradata Database reaches the specified threshold at the session level.
Set an alert to occur when the response time for a canary query exceeds the threshold.
Set an alert to occur when the system health of a Teradata Database reaches the specified level.
Migrating Alerts
After a Teradata System has been configured in Teradata Viewpoint, all of the alerts can be migrated from Teradata Manager to Teradata Viewpoint.
Note: Alerts can only be migrated when there are no alerts in Teradata Viewpoint for a
Teradata Database system; therefore, migrate existing Teradata Manager alerts before adding and copying alerts.
1
2
3
4
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Alerts.
From the ALERT TYPES list, click an alert type.
Under ALERTS, click Migrate Alerts.
Teradata Viewpoint User Guide 73
Chapter 7 System Administration
Teradata Systems
74
5
6
7
Enter a username and password that has permission to read data from the migrating database.
[Optional] Under SNMP Config, select the SNMP configuration assigned to any migrated action sets containing an SNMP action.
Note: This is required when the alert actions being migrated contain any SNMP actions.
The SNMP configurations are defined in the ALERT SETUP portlet.
Click Apply.
A message appears in the dialog box with the number of alerts that were migrated.
Adding and Copying Alerts
After a Teradata System has been configured in Teradata Viewpoint, an alert can be added.
Note: Alerts can only be migrated when there are no alerts in Teradata Viewpoint for a
Teradata Database system; therefore, migrate existing Teradata Manager alerts before adding and copying alerts.
1
2
3
4
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Alerts.
From the ALERT TYPES list, click an alert type.
Do one of the following:
• To add an alert, click .
• To copy an alert, click in the row of the alert you want to copy.
Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
5
6
7
8
9
10
11
12
The alert dialog box appears.
Enter a name for the alert.
[Optional] Select the Enabled check box to enable the alert.
Under Alert Rules, do the following: a b
[Database Space alert type only] Select databases to include or exclude.
Specify All databases, All databases except, or Only include databases.
c
Select a metric from the menus and type a threshold value.
You also have the option to add or remove rules.
The alert triggers based on the value entered.
d
[All alert types except for Session and Database Space] Type the number of minutes in the Only trigger if above is met for box.
The alert triggers if the rule is true for the amount of minutes you typed.
[Session alert type only] Under Except these users, type the name of the user.
You also have the option to add or remove users.
Any session with the user is excluded from receiving the alert.
Under Alert Actions, do the following: a
Select an alert action from the menu.
b
Type the number of minutes in the Do not run twice in box.
The alert action does not run twice in the minutes you typed.
Under Severity, select a severity from the menu.
[Optional] Under Message, type a message that appears when the alert action executes.
Click Apply to apply the settings.
The icon appears if the operation is successful. The icon appears if the operation fails. Verify that the settings are correct, and try again.
Deleting Alerts
An alert can be deleted any time after it has been added to a Teradata Database system.
1
From the SYSTEMS list, click the Teradata Database system name you want to update.
2
3
From the SETUP list, click Alerts.
From the ALERT TYPES list, click an alert type.
4
5
Under ALERTS, select the alert name.
Click in the row of the alert you want to delete.
Teradata Viewpoint User Guide 75
Chapter 7 System Administration
Teradata Systems
6
A confirmation message appears.
Click OK.
The alert row disappears.
Alert Metrics
The following table lists the metrics that you can specify in the system alert dialog box.
Metric Description Type
Node CPU Usage Average percent of CPU usage of all online nodes in the configuration Percent
Node Disk Usage Average percent of disk usage of all online nodes in the configuration Percent
Net A Usage Percent of BYNET A usage (BYNET receiver usage) Percent
AMP CPU Usage Average percent of CPU usage of all online AMPs in the configuration Percent
PE CPU Usage Average percent of CPU usage of all online PEs in the configuration Percent
Node CPU Skew Comparison of CPU use on the busiest node to the average node Percent
AMP CPU Skew Comparison of CPU use on the busiest AMP to the average AMP Percent
Total Sessions Total number of logged on sessions Number
Blocked Sessions Total number of blocked sessions Number
The following table lists the metrics that you can specify in the node alert dialog box.
Metric
Status
CPU Usage
Disk Usage
Net A Usage
CIC Usage
Description
Status of the node, where U means the resource is up and D means the resource is down
Percent of CPU usage that is not spent being active (not idle)
Percent of disk usage for this resource
Total BYNET utilization (average of the online BYNETs)
Percent of Channel Interface Controller usage for this resource
Disk Out Req Avg Average number of outstanding disk requests for this resource
Disk I/O Number of disk I/Os
Host I/O
Swaps
Mem Failures
Number of host I/Os
Total number of swap reads and swap writes
Segment allocation attempts that failed
Type
Character
Percent
Percent
Percent
Percent
Number
Number
Number
Number
Number
The following table lists the metrics that you can specify in the vproc alert dialog box.
Metric
Status
CPU Usage
Description
Status of the vproc, where U means the resource is up and D means the resource is down
Percent of CPU usage that is not spent being active (not idle)
Type
Character
Percent
76 Teradata Viewpoint User Guide
Chapter 7 System Administration
Teradata Systems
Metric
Disk Usage
CIC Usage
Description
Percent of disk usage for this resource
Percent of Channel Interface Controller usage for this resource
Disk Out Req Avg Average number of outstanding disk requests for this resource
Disk I/O Number of disk I/Os
Host I/O
Total Sessions
Number of host I/Os
Number of sessions logged on to the PE
Available AWT Total available AMP worker tasks
Message Count Messages waiting on the vproc
The following table lists the metrics that you can specify in the database space alert dialog box.
Metric
Current Perm
Max %
Description
Current Perm % Percentage of the total permanent disk space the database is currently using (Current Perm divided by Max Perm)
Current Perm Max * Number of Vprocs / Max Perm
Type
Percent
Percent
The following table lists the metrics that you can specify in the session alert dialog box.
Metric
Account
CPU Skew
Description
Account from which a query was submitted
CPU skew during the last sample
Type
Character
Percent
CPU delta
AMP CPU
Total CPU usage time consumed, in seconds, since the last sample Number
Current elapsed CPU time, in seconds, used on all AMPs by the associated session for executing requests
Number
Number AMP I/O Current number of logical Reads and Writes issued across all
AMPs by the associated session
Hot AMP CPU CPU time of the highest CPU utilized AMP during the collection interval
Number
Connection Time How long the session has been connected
Blocked Time How long the query has been blocked
Idle Time How long the query has been idle
Sessions Per User Number of sessions logged on under this username
Partition
Username
Partition to which the session is connected (SQL, CONSOLE,
MONITOR)
Name of the user who submitted the query
Number
Number
Number
Number
Character
Character
The following table lists the metrics that you can specify in the canary query alert dialog box.
Type
Percent
Percent
Number
Number
Number
Number
Number
Number
Teradata Viewpoint User Guide 77
Chapter 7 System Administration
Teradata Systems
Metric Description
Response Time Number of milliseconds it took for the canary query to return a response
Type
Number
Setting Monitor Rates
You can set Teradata Database internal sample rates for sessions, node logging, and vproc logging. The sample rate you set becomes the recommended sample rate for each collector.
Enabling the monitoring and logging process allows each collector to begin collecting data.
1
2
From the SYSTEMS list, click the Teradata Database system name you want to update.
From the SETUP list, click Monitor Rates.
78
3
4
5
6
7
[Optional] Do one of the following:
• Select the check box to enable monitoring and logging process.
• Clear the check box to disable monitoring and logging process.
[Optional] Type the Session Sampling sample rate in the text box.
The number you type becomes the recommended sample rate for the Sessions collector.
[Optional] Select the Node/Vproc Sampling sample rate.
The number you choose becomes the recommended sample rate for the System
Statistics collector.
[Optional] Select the Node logging and Vproc logging.
The number you choose becomes the recommended sample rate for the Resource Usage collector.
Click Apply to apply the settings.
Monitor Rates
After a Teradata System has been configured in Viewpoint, you can set Teradata Database internal sample rates for sessions, node/vproc, node logging, and vproc logging. These rates determine how often PM/API data are refreshed. The sample rates for node/vproc, node logging, and vproc logging must be an integer divisor of 3600.
Teradata Viewpoint User Guide
Sampling Types
Sessions
Node/Vproc
Node logging
Vproc logging
Viewing Disk Usage
1
Click Disk usage.
Chapter 7 System Administration
Teradata Systems
Recommended Sample Rate Maximum Sample Rate
30 seconds 3600 seconds
30 seconds 3600 seconds
600 seconds
600 seconds
3600 seconds
3600 seconds
2
The Disk usage view appears.
[Optional] Mouse over the sparkline and graph to activate the information balloons and see detailed information.
3
[Optional] Click in a Teradata Database system box in the graph to view the disk usage for each data collector on that Teradata Database system.
4
[Optional] Click the collector name in the graph to see the corresponding configuration dialog box.
Disk Usage Graphics
The graphics on the Disk usage view show disk usage over time and the distribution of data on the Teradata Viewpoint server.
Teradata Viewpoint User Guide 79
Chapter 7 System Administration
User Manager
Graphics
Sparkline
Graph
Description
Shows 3 months of data. Information balloons show detailed data about a point in time.
Shows how the space used by the Teradata Viewpoint server is divided among Teradata Database systems and their data collectors. Mouse over or click Teradata Database system boxes in the graph to see detailed disk space and data collector information. If a system contains a region that is not associated with a collector, the information balloon displays
Unknown and the amount of data space.
User Manager
User Manager
The User Manager portlet allows Teradata Viewpoint Administrators to manage Teradata
Viewpoint user accounts. Using this portlet, you can:
• Define or modify a user account.
• Reset forgotten or compromised passwords.
• Assign roles to users.
• Set role precedence.
• Search for existing users.
The User Manager portlet provides the following views:
USER LIST Allows you to add users or to search for and select an existing user account to modify. A search tool is provided to help locate an individual user or groups of users when the user list is long. It is the default view.
USER
DETAILS
Shows details about the selected user. This view includes the following tabs:
• General (default): Modify the selected user's account, including name and email address.
• Roles: Assign available roles to the selected user and set role precedence.
Note: A role must be defined using the Roles Manager portlet before it can be assigned to a user.
About the User List View
The User List view provides a list of all Teradata Viewpoint system users. Initially displayed are FIRST NAME, LAST NAME, PORTAL USER NAME, and EMAIL for each user. You can view, select, and search for individual user details.
80 Teradata Viewpoint User Guide
Chapter 7 System Administration
User Manager
You can modify how the information is displayed by:
• Resizing the column width
• Sorting the contents of a column alphabetically
You can also add Teradata Viewpoint accounts from the User List view.
Adding a User
This task describes how to add a user account. You must have Teradata Viewpoint
Administrator privileges to access the User Manager portlet.
If your Teradata Viewpoint portal is configured to use auto-provisioning, a user account is created automatically the first time a user logs on to Teradata Viewpoint. By default, autoprovisioned accounts are authenticated externally and assigned a default role. The authentication program (for example, LDAP) and default role are set during configuration.
1
From the User List view, click Add User.
A dialog box appears with the General tab selected (default).
2
Enter the user's:
• First name
• Last name
• Email address
Teradata Viewpoint User Guide 81
Chapter 7 System Administration
User Manager
3
4
5
6
Choose an authentication method:
• Select the Externally Authenticated check box to authenticate the selected user from an external source, such as LDAP.
• Clear the Externally Authenticated check box to authenticate the selected user from the Teradata Viewpoint internal database.
In the Password field, enter a preliminary password for the user account.
If using external authentication, such as LDAP, the password fields do not appear in this dialog box. The password is stored in the external source and validated from that source.
In the Re-enter Password field, enter the password again, exactly as it was entered previously.
Click Apply.
A confirmation message appears.
Searching for a User
This task describes how to search for an existing Teradata Viewpoint user, resize columns, and sort the information in the columns.
1
From the User List view, click the Find Users list.
2
3
Select one of the following:
• First Name. Search for all users with first names that contain the search criterion.
• Last Name. Search for all users with last names that contain the search criterion.
• Portal Username. Search for all users with portal usernames that contain the search criterion.
• Email. Search for all users with email addresses that contain the search criterion.
• Portal Role. Search for all users assigned to a portal role name that contains the search criterion.
In the contains field, enter the search criterion.
4
Click Find.
Users with information matching the search criterion are listed in the search results.
82 Teradata Viewpoint User Guide
Chapter 7 System Administration
User Manager
5
[Optional] Drag the column border in either direction to resize the column.
6
[Optional] Sort on a column by clicking the column heading.
Configuring Columns to Display
Use the Columns dialog box to change the column display order. From the table, you can resize columns and sort the information in the columns.
1
2
3
4
5
In the table, click .
[Optional] Click and drag the row to reorder the column.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
6
[Optional] Sort on a column by clicking the column heading.
About the User Details View
The user details view allows you to delete a user, edit Teradata Viewpoint user accounts, and assign roles to users.
Teradata Viewpoint User Guide 83
Chapter 7 System Administration
User Manager
84
You can use the Delete User button or the General and Roles tabs to manage user accounts and details:
General Edit the selected user account, or delete the account from the user list. The
General dialog box allows you to:
• Change the user's First Name, Last Name, and Email address
• Change an existing Password.
• Select Externally Authenticated for accounts authenticated by LDAP or another source external to Teradata Viewpoint.
Note: If the Externally Authenticated check box is selected, the passwordrelated fields are not available in the dialog box.
Roles Manage role assignments and priority. The Roles dialog box provides a list of available roles. Roles can be selected and assigned to the current user account. Use the Roles tab to:
• Assign available roles to, or remove them from, the selected user.
• Set role priority.
Note: A role must be defined using the Roles Manager portlet before it can be assigned to a user.
Assigning User Roles
This task describes how to assign roles to an existing Teradata Viewpoint user account. If your Teradata Viewpoint portal is configured to use auto-provisioning, a user account is created automatically the first time a user logs on to Teradata Viewpoint. By default, autoprovisioned accounts are authenticated externally and assigned a default role. The authentication source (for example, LDAP) and default role are set during configuration.
1
From the User List view, browse the list of users or click Find Users to perform a search.
Teradata Viewpoint User Guide
Chapter 7 System Administration
User Manager
2
3
Click a user's name.
The General tab appears and displays information about the selected user.
Click the Roles tab.
The Roles dialog box appears. Existing roles are listed in the AVAILABLE PORTAL
ROLES pane. Roles assigned to the user are shown in the ROLES FOR <User> pane.
4
5
Assign portal roles to this user:
• To assign one role to the selected user, select the role from the list under
AVAILABLE PORTAL ROLES.
• To assign more than one role to the selected user, hold CTRL while selecting multiple roles from the list under AVAILABLE PORTAL ROLES.
Click .
The selected roles appear in the ROLES FOR <User> pane. In the AVAILABLE
PORTAL ROLES pane, the assigned roles are dimmed.
6
Click Apply.
Setting Role Priority
This task describes how to set role priority for existing Teradata Viewpoint roles. Roles assigned higher priority take precedence over lower-priority roles.
1
2
From the User List view, browse the list of users or click Find Users to perform a search.
Click a user's name.
Teradata Viewpoint User Guide 85
Chapter 7 System Administration
User Manager
3
4
5
The General tab appears and displays information about the selected user.
Click the Roles tab.
Select a role from the ROLES FOR <User> pane to change the role's priority.
Change the role priority by doing one of the following:
• Click Up to increase the selected role priority. Roles at the top of the list have higher priority.
• Click Down to decrease the selected role priority. Roles at the bottom of the list are lower in priority.
86
6
Click Apply.
Editing a User
This task describes how to edit an existing Teradata Viewpoint user account.
1
2
3
4
5
From the User List view, browse the list of users or click Find Users to perform a search.
Click a user's name.
The General tab appears and displays information about the selected user.
[Optional] Change any of the following information:
• First name
• Last name
• Email address
Note: The portal username cannot be changed. The username is defined when the user account is created using the User Manager portlet or it is stored in LDAP when the user is externally authenticated.
Choose an authentication method:
• Select the Externally Authenticated check box to authenticate the selected user from an external source, such as LDAP.
• Clear the Externally Authenticated check box to authenticate the selected user from the Teradata Viewpoint internal database.
[Optional] Change the password: a
Select the Change Password check box.
Teradata Viewpoint User Guide
Chapter 7 System Administration
User Manager
6 b
The Password and Re-enter Password fields change color.
In the Password field, enter the password.
c
In the Re-enter Password field, enter the password again, exactly as it was entered previously.
Note: If Externally Authenticated is selected, the Change Password check box and related password fields are unavailable, and the user's password must be changed in the external source.
Click Apply.
Changing a User Password
This task describes how to change a Teradata Viewpoint user password.
Note: If Externally Authenticated is selected, the Change Password check box and related password fields are unavailable, and the password must be changed in the external source.
1
2
3
4
5
6
From the User List view, browse the list of users or click Find Users to perform a search.
Click a user's name.
The General tab appears and displays information about the selected user.
Select the Change Password check box.
Note: If Externally Authenticated is selected, the Change Password check box and related password fields are unavailable, and the password must be changed in the external application.
The Password and Re-enter Password fields change color.
In the Password field, enter a password.
In the Re-enter Password field, enter the password again, exactly as it was entered previously.
Click Apply.
Deleting a User
This task describes how to delete a Teradata Viewpoint user account.
1
2
3
4
From the User List view, browse the list of users or click Find Users to perform a search.
Click a user's name.
The General tab appears and displays information about the selected user.
Click Delete User.
A confirmation message appears.
Note: If Delete User does not appear, it is because you are logged on under the user account you are trying to delete.
Click OK.
Teradata Viewpoint User Guide 87
Chapter 7 System Administration
User Manager
88 Teradata Viewpoint User Guide
CHAPTER 8
Alert Viewer
Alert Viewer
The ALERT VIEWER portlet allows users to view alerts defined for the system. The alert information in the summary view is updated every 30 seconds. Every alert has a timestamp, displaying the date and time at which the alert was issued.
You can filter the alerts by for example severity, time period, type, or name. You can also combine the filters to narrow the results further.
The ALERT DETAILS view provides detailed information about what triggered the alert, the source of the alert, and any relevant messages.
About Alerts
An alert is an event that your Teradata System Administrator defined as being significant.
The Teradata System Administrator assigns alert severity to rank alerts; critical, high, medium, or low, and can also provide an explanatory message. The alerts displayed in the
ALERT VIEWER are specific to your system.
Common Alert Example
The Teradata System Administrator can define that a database exceeding a certain amount of used storage, triggers an alert. This alert appears in the ALERT VIEWER with details that assist in performing cleanup before the database is full.
Teradata Viewpoint User Guide 89
Chapter 8 Alert Viewer
Alert Viewer
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can sort the information in the columns. Filtering allows you to:
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filtering By Severity
Narrow the results to show only alerts with a certain severity; all, critical, medium, high, or low.
1
In the toolbar, click the button of the severity you want to display.
The view shows alerts with the selected severity and the severity label is bold.
Selecting a Time Period
Narrow the results to show alerts issued within the last 5 minutes, 1 hour, 1 day, or 1 week.
1
Select a time period from the list.
The view shows alerts reported within the time period you selected.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, and change the column display order. In the table, you can resize columns.
1
2
3
4
5
6
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
90 Teradata Viewpoint User Guide
Chapter 8 Alert Viewer
Alert Viewer
The column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2
3
To clear all filter boxes all at one time, mouse over the filter .
The filter icon changes to .
Click .
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Viewing Alert Details
The ALERT DETAILS view provides additional details about a specific alert. The details include information about what triggered the alert, the source of the alert, and any relevant messages.
1
In the summary view, click anywhere in a row to access alert details.
The ALERT DETAILS view appears. If the Source is Viewpoint, the following two fields appear:
• Alert Type. The system action defines the alert type.
• Resulting Action. The Teradata Administrator defines the resulting action in Teradata
Systems Alerts.
Teradata Viewpoint User Guide 91
Chapter 8 Alert Viewer
Alert Viewer
92 Teradata Viewpoint User Guide
CHAPTER 9
Calendar
Calendar
The CALENDAR portlet allows you to schedule and communicate events that might impact one or more Teradata Database systems. You must have appropriate permissions to manage system events. Unlike other portlets, only one instance of the CALENDAR portlet can be open in the Teradata Viewpoint portal. After the CALENDAR portlet is added to a portal page, the Calendar menu option is no longer available on the Tools menu.
The CALENDAR portlet provides the following views:
Week
View
Month
View
The Week view displays all events between Sunday and Saturday of the selected week. In this view, only one day of the week is expanded at a time and event indicators on other days of the week are displayed at the scheduled time in the appropriate day column.
The Month view displays all events with start times falling between Sunday prior to the start of the selected month and Saturday after the end of the month. In this view, event indicators are color-coded squares.
An event cannot last longer than 24 hours. You can define a time and priority to an event and, when you save it, an event indicator (a colored box) appears in the Week view or
Month view. A blue indicator means normal and a red indicates high priority events. Mouse over an event indicator to display details about the event. All times shown are for the time zone defined in the user profile.
About the Calendar Week View
The Week view displays all events falling between Sunday and Saturday of the selected week.
In this view, only one day of the week can be expanded at a time. The selected day can include one or more event summaries. The summary shows the event start and end times, and the event title. The remaining days are collapsed into narrow columns. Click in any day column to expand and display a different day of the week. Today's date is shaded darker if it falls within the selected week.
Teradata Viewpoint User Guide 93
Chapter 9 Calendar
Calendar
From the Week view, you can see event details by clicking anywhere in the event summary or event indicator. Events scheduled on other days of the week are indicated by a vertical line located at the scheduled time in the appropriate day column.
Add Event
Today
Open the Add Event dialog box to add an event to the calendar.
View today in the weekly calendar.
Display the Week view.
Display the Month view containing the selected week.
Display the previous week.
Display the next week.
About the Calendar Month View
The Month view displays all events with start times that occur during the selected month.
Events shown in the selected month that start either in the previous or following month are indicated by a lighter color. Today is shaded darker if it falls within the selected month.
94 Teradata Viewpoint User Guide
Chapter 9 Calendar
Calendar
From the Month view, you can see event details by clicking on a date (number) or an event indicator.
Add Event Open the Add Event dialog box to add an event to the calendar.
Today Open the monthly calendar that includes today.
Display the Week view. If you click the date (number), the selected day is expanded in the Week view.
Display the Month view.
Display the previous month.
Display the next month.
About the Calendar Event Details View
The Event Details view displays the details of the selected event, including event priority, who created it (the author), whether it was modified, and when it is scheduled to occur. The event title and description are also included in this view.
Teradata Viewpoint User Guide 95
Chapter 9 Calendar
Calendar
From this view, you can manage the calendar and scheduled events.
Back
Edit
Delete
Return to the last displayed calendar view.
Open the Edit Event dialog box to edit the event details.
Delete this event.
Display the Week view containing the event.
Display the Month view containing the event.
Display the previous event.
Display the next event.
Adding an Event
Adding an event changes the system event calendar and affects all users. By default, new events are added to the currently selected day.
1
From either the Calendar Week or Month view, click Add Event.
The ADD EVENT dialog box appears with the current date in the START and END date fields.
96 Teradata Viewpoint User Guide
Chapter 9 Calendar
Calendar
2
Set the START date: a
Click inside the START date field.
A pop-up calendar appears.
3
4
5
6 b Click or to navigate to the appropriate month.
c
Select the date from the pop-up calendar.
Set the END date.
Select the event START and END times from the list.
Select AM (morning) or PM (afternoon) from the list.
Select a priority:
Teradata Viewpoint User Guide 97
Chapter 9 Calendar
Calendar
7
8
9
• Normal (default)
• High
Enter the EVENT TITLE.
[Optional] Enter the event DESCRIPTION.
Click OK.
Editing an Event
Editing an event changes the event instance affecting all users.
1
From either the Calendar Week or Month view, select the event you want to edit.
The event details view appears.
2
Click Edit.
The EDIT EVENT dialog box appears, showing event details.
98
3
Set the START date: a
Click inside the START date field.
A pop-up calendar appears.
Teradata Viewpoint User Guide
Chapter 9 Calendar
Calendar
4
5
6
7
8
9
10 b Click or to navigate to the appropriate month.
c
Select the date from the pop-up calendar.
Set the END date.
Select the event START and END times from the list.
Select AM (morning) or PM (afternoon) from the list.
Select a priority:
• Normal (default)
• High
Enter the EVENT TITLE.
[Optional] Enter the event DESCRIPTION.
Click OK.
Deleting an Event
Deleting an event removes the event instance from the database and affects all users.
1
2
3
From either the Calendar Week or Month view, select the event you want to delete.
In the Event Details view, click Delete to remove the event from the calendar.
A confirmation message appears.
Click OK.
Teradata Viewpoint User Guide 99
Chapter 9 Calendar
Calendar
100 Teradata Viewpoint User Guide
CHAPTER 10
Canary Response Times
Canary Response Times
The CANARY RESPONSE TIMES portlet allows you to analyze trends in single-system performance over a 60-minute or a 120-minute period using canary queries. Canary queries measure the time in milliseconds it takes for a user-defined query to run to completion. The same query is run repeatedly at a preselected interval to compare system workload over time. The longer the query takes to complete, the heavier the system workload at that time.
Canary response times can help you plan maintenance activities or schedule your workloads appropriately. For example, you can use this portlet to identify heavy workload periods on a
Teradata Database system so that you can avoid assigning tasks when system performance is marginal. You can also use canary response times to compare current performance with average performance measured across 1 or more weeks of historical data. Additionally, you can monitor and compare the performance of multiple Teradata Database systems by adding a CANARY RESPONSE TIMES portlet to the portal page for each monitored system.
The summary view provides a graphic overview of selected canary query metrics monitored over the previous 60-minute or 120-minute period. Samples are taken once every minute, and a data point is added to the graph for each selected canary query metric.
Use the PREFERENCES view to select and organize canary query metrics to display, change thresholds, and adjust the vertical axis range for each metric. The Teradata Viewpoint
Administrator defines default metrics for the CANARY RESPONSE TIMES portlet in the
CONFIGURATION portlet. If enabled for your profile, you can set metrics that override the defaults.
The CANARY RESPONSE TIMES portlet also gives you a means for comparing current and historical data by displaying past performance as an average of metric data points collected over time. The duration over which the averages are calculated can be changed using the Past Averages tab.
About the Canary Response Times View
The CANARY RESPONSE TIMES portlet monitors the workload of a single Teradata
Database system over time. The summary view shows current and historical performance data using sparklines. The sparkline is a horizontal graph, showing the time (in milliseconds) a query takes to complete.
You can monitor the performance of multiple systems by adding a CANARY RESPONSE
TIMES portlet instance for each Teradata Database system you want to monitor. Canary response times, such as SYSTEM HEARTBEAT, are represented by a data point that is
Teradata Viewpoint User Guide 101
Chapter 10 Canary Response Times
Canary Response Times added to the sparkline once every 60 seconds. Mouse over a sparkline to see an information balloon containing detailed information about the data point.
The sparkline types are:
Current
Data
Shows the time (in milliseconds) that a query takes to complete. Each data point shown on the sparkline is the average of all response times recorded during a 120second interval, by default. The result is a curve sparkline. A large dot at the
NOW point on the sparkline indicates the value of the last data point captured.
A number to the right of the sparklines also indicates the NOW data-point value.
Note: The Teradata Viewpoint Administrator sets the default data collection rate.
Past
Average
Presents the averages for a user-selected number of weeks. The sparkline is shown as a skyline chart with flat, solid data points. Use this sparkline to compare the current performance from the previous 60-minute or 120-minute period with the system performance during the same 60-minute or 120-minute period 1 or more weeks in the past. Use the past-average data shown from
NOW to 30 minutes or 60 minutes in the future to estimate system workload and enhance decision-making regarding workload assignments and resource allocation.
102
The summary views are:
Normal The skyline shows 90 minutes of the average-workload data values from a userselected number of weeks in the past. The curve sparkline shows the actual data for the past 60 minutes using 1-minute data points.
Maximized The skyline shows 180 minutes of the average-workload data values from a userselected number of weeks in the past. The curve sparkline shows the actual data for the past 120 minutes using 1-minute data points.
Toggle between the normal and maximized summary views using the (maximize) and
(minimize) portlet buttons.
Canary Response Times Metrics
The metrics available for display are canary queries.
Teradata Viewpoint User Guide
Metric
System Heartbeat
<canary query name> CQ
Default
Sparkline
Curve
Curve
Chapter 10 Canary Response Times
Canary Response Times
Past Average
Line
Yes
Yes
Description
The predefined metric that is available for all systems. This is the default canary query.
Canary queries defined by the Teradata Viewpoint
Administrator appear on the Metrics tab.
About the Preferences View
The PREFERENCES view allows you to customize the portlet to monitor key metric trends that are important to efficient operation of your Teradata Database system. You can select only one system to monitor for each portlet instance.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
System
Metrics
Settings
Past
Averages
Select a Teradata Database system to monitor.
Select and organize metrics to monitor in the summary view. Drag metrics from a list of all available metrics to the Preview pane where you can preview the results as you go.
Define settings for the metrics selected for display. Set thresholds to highlight metric values that are outside normal operating ranges. Set maximum vertical-axis ranges to limit the range of values displayed for selected metrics.
Adjust the number of weeks of data points used to calculate the average value for each displayed metric.
Selecting a System to Monitor
Use the System tab in the PREFERENCES view to select a Teradata Database system to monitor. Only one system can be selected for each portlet instance.
1
2
3
4
From the portlet frame, click to access the PREFERENCES view.
Click the System tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a system from the list.
5
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Teradata Viewpoint User Guide 103
Chapter 10 Canary Response Times
Canary Response Times
6
Click OK.
Selecting Metrics to Monitor
Use the Metrics tab in the PREFERENCES view to select and organize the metrics shown in the summary view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
The Preview pane uses sample data to show how metric rows are displayed in the summary view.
104
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do any of the following to change the way metric rows are displayed:
• Add a metric row. Drag a metric from the Select metrics for display list to the
Preview pane.
• Remove a metric row. Drag a metric from the Preview pane to the Metric Removal pane.
• Change metric row order. Drag a metric already in the Preview pane to a new location in the pane (up or down).
Note: Changes to the metrics affect only the system currently selected, provided that the metrics are available on that system.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Metric Thresholds
Use the Settings tab in the PREFERENCES view to set the THRESHOLD and VERTICAL
AXIS RANGE values for the metrics selected for display. Only metrics selected using the
Teradata Viewpoint User Guide
Chapter 10 Canary Response Times
Canary Response Times
Metrics tab appear in the list of available metrics. Changes to the metrics affect only the system currently selected, provided that the metrics are available on that system.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Settings tab.
3
4
5
6
7
[Optional] Click Clear Defaults to clear all default settings for this portlet.
[Optional] Enter the THRESHOLD setting for each available metric.
The threshold line does not appear in the view when the value entered is zero or blank.
[Optional] Enter the VERTICAL AXIS RANGE for each available metric.
The sparkline scales automatically when the value entered is zero or blank.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Past Averages
Use the Past Averages tab in the PREFERENCES view to specify the number of weeks of data points used to calculate the average values displayed in metric graphs.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Past Averages tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter the number of weeks (1 to 99 weeks).
The default is 2 weeks.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 105
Chapter 10 Canary Response Times
Canary Response Times
106 Teradata Viewpoint User Guide
CHAPTER 11
Capacity Heatmap
Capacity Heatmap
The CAPACITY HEATMAP portlet allows you to analyze resource usage trends on a
Teradata Database system to identify periods when a system is either over-utilized or underutilized. You can use this information to schedule resource-intensive jobs with minimal impact to other users.
The CAPACITY HEATMAP portlet displays a grid with days on the horizontal axis and hours on the vertical axis. The metric and system are selected using selection menus. Timerange buttons on the toolbar allow you to select 1-month or 3-month periods. Each colorcoded square represents an hour and provides a visual indication of the metric value during a 1-hour period.
The PREFERENCES view allows you to set the work week and shift specifications.
About the Capacity Heatmap View
The CAPACITY HEATMAP view provides a graph of variations and trends in system resource usage. The graph plots days on the horizontal axis and hours along the vertical axis.
Customize the view using the menus, toolbar, and date-range slider to select metrics and date ranges.
The following list describes the features in this view:
Selection
Menus
Toolbar
Date-Range
Slider
Cell
Shows the selections that define the metric currently being displayed. You can change the metric by changing the selections.
Contains the time-range buttons. Select a time-range button to change the graph. You can use the Display and threshold buttons to define how the cells are shaded. The time-range start and end dates are displayed on the toolbar next to the time-range buttons.
Controls the amount of historical data displayed in the view and adjusts to display from 1 week to approximately 4 months of historical data. Dates outside the date-range slider timeline are shaded lighter. The darkershaded area between the slider handles represents the current date range being displayed.
Contains data about an hour on a specific date in the graph. Mouse over any cell to display an information balloon containing the date, hour, and metric value for the 1-hour block.
Teradata Viewpoint User Guide 107
Chapter 11 Capacity Heatmap
Capacity Heatmap
Work Week and Shift
Indicator
Highlights times when most users are normally accessing system resources with a box around the work week and work shift hours. Specify work day and shift hours using the PREFERENCES view.
108
Trend-Reporting Metrics
Database Metrics
Metric
Current Perm
Current Perm Max
Current Perm Min
Current Spool
Current Spool Max
Current Spool Min
Current Temp
Current Temp Max
Description
Sum of the current amount of permanent space (disk space) used across all vprocs
Maximum permanent space used on a single vproc
Minimum permanent space used on a single vproc
Sum of the current amount of spool space (disk space) used across all vprocs
Maximum spool space used on a single vproc
Minimum spool space used on a single vproc
Sum of the current amount of temporary space (disk space) used across all vprocs
Maximum temporary space used on a single vproc
Type
Number
Number
Number
Number
Number
Number
Number
Number
Teradata Viewpoint User Guide
Chapter 11 Capacity Heatmap
Capacity Heatmap
Metric
Current Temp Min
Peak Perm
Peak Perm Max
Peak Perm Min
Peak Spool
Peak Spool Max
Peak Spool Min
Peak Temp
Peak Temp Max
Peak Temp Min
Perm Limit
Spool Limit
Temp Limit
Description
Minimum temporary space used on a single vproc
Sum of the largest amount of permanent space used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of permanent space used on a single vproc since the last reset
Minimum of the largest amount of permanent space used on a single vproc since the last reset
Sum of the largest amount of spool used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of spool used on a single vproc since the last reset
Minimum of the largest amount of spool used on a single vproc since the last reset
Sum of the largest amount of temporary space used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of temporary space used on a single vproc since the last reset
Minimum of the largest amount of temporary space used on a single vproc since the last reset
Maximum space available for permanent space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Maximum space available for spool space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Maximum space available for temporary space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Type
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Performance Metrics
Metric
Blocking Duration
Concurrency
Response Time
Retrieve Time
Rows Returned
Total Time
Description
Total time the heartbeat query is blocked
Type
Number
Number Average number of active tasks running on the Teradata
Database while the heartbeat query is running
Average response time of the selected canary query Number
Average time to retrieve all results Number
Average number of rows returned by the selected canary query Number
Combined response time and retrieve time Number
Teradata Viewpoint User Guide 109
Chapter 11 Capacity Heatmap
Capacity Heatmap
Query Metrics
Metric
Abort Total
Active AMPs Avg
Active AMPs Max
Description
Number of aborted queries
Average number of active AMPs
Maximum number of active AMPs
Active AMPs Min
Active AMPs Stddev
Minimum number of active AMPs
Standard deviation of active AMPs
AMP CPU Skew Avg Average percent of AMP CPU skew
AMP CPU Skew Max Maximum percent of AMP CPU skew
AMP CPU Skew Min Minimum percent of AMP CPU skew
AMP CPU Skew Stddev Standard deviation percent of AMP CPU skew
AMP I/O Skew Avg
AMP I/O Skew Max
Average percent AMP I/O skew
Maximum percent AMP I/O skew
AMP I/O Skew Min Minimum percent AMP I/O skew
AMP I/O Skew Stddev Standard deviation of AMP I/O skew
Cache Total
Concurrency
Number of queries found in step cache
Average number of queries executing simultaneously during the hour
Delay Time Avg
Delay Time Max
Delay Time Min
Delay Time Stddev
First Response Time
Avg
First Response Time
Max
First Response Time
Min
First Response Time
Stddev
Average query delay time
Maximum query delay time
Minimum query delay time
Standard deviation of query delay time
Average time it takes to receive the first response
Maximum time it takes to receive the first response
Minimum time it takes to receive the first response
Number
Number
Number
Number
Number
Number
Number
Standard deviation of time it takes to receive the first response Number
Type
Number
Number
Number
Number
Number
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Number
Number
Max Steps in
Parallelism Avg
Max Steps in
Parallelism Max
Max Steps in
Parallelism Min
Average number of level-2 query steps executed in parallel
Maximum number of level-2 query steps executed in parallel Number
Minimum number of level-2 query steps executed in parallel
Number
Number
110 Teradata Viewpoint User Guide
Chapter 11 Capacity Heatmap
Capacity Heatmap
Metric
Max Steps in
Parallelism Stddev
Description
Standard deviation of number of level-2 query steps executed in parallel
Number of Steps Avg Average number of query steps
Number of Steps Max Maximum number of query steps
Number of Steps Min Minimum number of query steps
Number of Steps Stddev Standard deviation of number of query steps
Query Count Queries logged in dbc.QryLog, or the sum of Querycount from dbc.QryLogsummary during the sample period
Query Seconds Avg
Query Seconds Max
Average query run time
Maximum query run time
Query Seconds Min Minimum query run time
Query Seconds Stddev Standard deviation of query run time
Result Rows Avg
Result Rows Max
Result Rows Min
Result Rows Stddev
Average number of result rows
Maximum number of result rows
Minimum number of result rows
Standard deviation of number of result rows
Spool Usage Avg
Spool Usage Max
Spool Usage Min
Spool Usage Stddev
Steps with Parallelism
Avg
Steps with Parallelism
Max
Steps with Parallelism
Min
Steps with Parallelism
Stddev
Average amount of spool the query used
Maximum amount of spool the query used
Minimum amount of spool the query used
Standard deviation of amount of spool the query used
Average number of query steps with parallel steps
Maximum number of query steps with parallel steps
Minimum number of query steps with parallel steps
Type
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Standard deviation of number of query steps with parallel steps Number
Number
Number
Number
Number
Number
Number
Number
Number
Total CPU Time Avg Average CPU time
Total CPU Time Max Maximum CPU time
Total CPU Time Min Minimum CPU time
Total CPU Time Stddev Standard deviation of CPU time
Total I/O Count Avg Average I/O count
Total I/O Count Max Maximum I/O count
Total I/O Count Min Minimum I/O count
Number
Number
Number
Number
Number
Number
Number
Teradata Viewpoint User Guide 111
Chapter 11 Capacity Heatmap
Capacity Heatmap
Metric Description
Total I/O Count Stddev Standard deviation of I/O count
Warning Total Total number of queries with warnings
Type
Number
Number
System Metrics
Metric
Active Sessions
AMP CPU Skew
AMP I/O Skew
Average Outstanding
Disk Reqs
Description
Number of sessions with active queries
Type
Number
Comparison of CPU use on the busiest AMP to the average AMP Percent
Comparison of disk use on the busiest AMP to the average AMP Percent
Outstanding disk requests (disk queue size) Number
AWT
Components
Average number of AMP worker tasks in use on each AMP Number
Number of components, such as BYNETs or AMPs that are down
Number
CPU Average node CPU use
CPU AWT Processing CPU resources spent processing an AMP worker task
Percent
Percent
CPU/Disk Ratio
CPU Dispatcher
Processing
Ratio of CPU use to disk use
CPU resources spent in PE Dispatcher processing
Percent
Percent
DBC Disk Space
Disk I/O
Disk Reads
Disk Usage
Available DBC disk space in use
Number of disk I/Os
Percent
Number
Total physical disk reads per system during the sample period Number
Disk use on the system Percent
Disk Writes
FSG Cache Miss
Host Block Reads
Total physical disk writes per system during the sample period Number
Physical I/Os divided by the logical I/Os Number
Total message blocks (one or more messages sent in one physical group) received from all clients
Total message blocks sent to all hosts
Number
Number Host Block Writes
Index Ratio
Logical MB/Second
Index I/Os divided by the data block I/Os
Logical I/O of the system in megabytes per second
Max Disk Space By AMP Available disk space currently in use
Max Spool Space By
AMP
Available spool space in use
Number
Number
Percent
Percent
Memory Failures
Memory Resources
Net A Usage
Total memory failures across all nodes
Total segments allocated to memory resources
Percent of BYNET A usage (BYNET receiver usage)
Number
Number
Percent
112 Teradata Viewpoint User Guide
Chapter 11 Capacity Heatmap
Capacity Heatmap
Metric
Net Reads
Net Writes
Description
Total reads from the BYNET during the sample period
Type
Number
Total messages written to the BYNET during the sample period Number
Node CPU Skew
Node CPU Usage
Node I/O Skew
Nodes Down
Parallelism
Parser Usage
PE CPU Usage
Comparison of CPU use on the busiest node to the average node Percent
Average percent of CPU usage of all online nodes in the configuration
Percent
Comparison of disk use on the busiest node to the average node Percent
Number of system nodes down Number
Percentage of parallelism, calculated as the average CPU usage / maximum CPU usage x 100
Percent of CPU time the parser uses. It might exceed 100%
Average CPU usage of the PEs, calculated as the average usage of the parser and the dispatcher
Percent of I/O that are reads
Percent
Percent
Percent
Percent Read I/O
Session Login Count Sessions currently logged on to the system
Swap Drops Total pages or segments dropped from memory during the sample period due to swapping
Swap Reads
Swap Writes
Total pages or segments read into memory from the disk after a prior write or drop during the sample period
Total pages or segments written into swap area from memory during the sample period
Number
Number
Number
Number
System CPU
Total AMP CPU
Total Disk Space
Total Node CPU
User CPU
Vproc CPU Usage
Wait I/O CPU
Average CPU time spent in System mode
Total AMP CPU use
Total disk space currently in use
Total node CPU use
Average CPU time spent in User mode
Average percent of the CPU usage of all online vprocs in the configuration
Average CPU time spent waiting for I/O
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Table Metrics
Metric
Index Count
Table Size
Description
Total number of indexes
Table size in bytes, including index, fallback, and journal subtables
Type
Number
Number
Teradata Viewpoint User Guide 113
Chapter 11 Capacity Heatmap
Capacity Heatmap
About the Capacity Heatmap Menus and Toolbar
The menus and toolbar allow you to specify the display attributes of the CAPACITY
HEATMAP view.
114
Use the selection menus to define a metric to monitor by selecting a:
• System
• Category
• Metric
• Source or Variant
Note: The first time you add the portlet to the page, the first available metric that you have permission to view is displayed. However, if you only have permission to view Table metrics, no data appears in the portlet until you select a metric using the selection menus.
The 1 mo and 3 mo buttons allow you to adjust the time range displayed. When clicked, 1 month or slightly more than 3 months of data up to the current end date appears in the view.
As you adjust the time range, the toolbar refreshes automatically to display the new time range in the toolbar.
The Display button allows you to show or hide cell values and adjust high and low values that determine cell shading.
Note: The Display cell values check box is only available when the metric displayed is a percentage. If the selected time range results in narrow cells, cell values are not displayed even though the Display cell values check box is selected.
The threshold button displays the current threshold value and allows you to set the threshold slider and adjust the threshold.
Note: The threshold button and slider only appear when the metric displayed is a percentage.
If the threshold value is within the gray-scale range defined in the DISPLAY OPTIONS menu, the cells are displayed in a shade of the exception color equivalent to the corresponding gray-scale shade for that cell value.
Selecting Metrics and Systems to Monitor
You can use selection menus above the toolbar to choose a metric and system to monitor in the portlet, starting with the highest level menu on the far left. Different menus choices are available based on the previous menu, so not all menus apply to all metrics.
Note: You are not required to make a selection from every menu each time you modify a metric selection.
1
In the selection menu, click the currently selected system name to display a list of available systems.
Teradata Viewpoint User Guide
Chapter 11 Capacity Heatmap
Capacity Heatmap
2
3
4
5
6
7
8
9
Select a system from the menu.
Click Next.
Select a category from the menu.
Click Next.
Select a metric from the menu.
Click Next.
[Optional] Select a source or variant from the menu.
Note: The menu for source or variant (sum, average, minimum, maximum, standard deviation of that metric) is only available for certain metric categories.
Click Next.
Adjusting the Date Range
Use the toolbar to set the range of dates to display for the selected metric and system.
1
Mouse over the date-range slider to activate the start-date and end-date handles.
2
Drag the start-date handle until the intended start date is displayed in the toolbar (upper left).
3
4
5
6
Drag the end-date handle until the intended end date is displayed in the toolbar.
[Optional] Drag the date-range slider left or right to move the start-date and end-date handles in unison.
[Optional] Click 1 mo.
One month of historical data is displayed ending at the current end date.
[Optional] Click 3 mo.
Slightly more than three months of historical data is displayed ending at the current end date.
Setting Cell Values and Shading
The DISPLAY OPTIONS dialog box allows you to display cell values and to set metric thresholds for applying cell shading for each system monitored. The shading provides a visual overview by highligting interesting values.
Teradata Viewpoint User Guide 115
Chapter 11 Capacity Heatmap
Capacity Heatmap
Note: You must repeat this procedure for each available metric to ensure appropriate shading is applied when the metric is selected.
1
2
3
4
From the CAPACITY HEATMAP view, click Display.
The DISPLAY OPTIONS dialog box appears.
Do one of the following:
• Select the Display cell values check box to display cell values.
• Clear the Display cell values check box to display cells without values.
Note: The Display cell values check box is only available when the metric displayed is a percentage. If the selected date range results in narrow cells, cell values are not displayed even though the Display cell values check box is selected.
Set the lower and upper threshold values in the Apply shading to values between boxes.
Click OK.
Values below the defined range appear in a very light shade of gray, while values above the range have a very dark shade. Values within the defined range appear in three shades of gray.
Setting the Threshold Value
The threshold button displays the current threshold value. Use the threshold button to access the threshold slider and adjust exception highlighting to show when the system is overutilized or under-utilized.
Note: The threshold button and slider only appear when the metric displayed is a percentage.
1
In the toolbar, click the threshold button.
The threshold slider appears.
116
2
Do one of the following:
• Click to set an upper threshold, highlighting all values greater than the selected value in shades of red.
• Click to set a lower threshold, highlighting all values less than the selected value in shades of gray.
Teradata Viewpoint User Guide
Chapter 11 Capacity Heatmap
Capacity Heatmap
3
4
Drag up or down to adjust the threshold value.
The CAPACITY HEATMAP view highlights change to reflect values above or below the threshold setting.
Click anywhere off the threshold slider to close the slider and return to the portlet.
About the Preferences View
The PREFERENCES view allows you to specify the work days and hours that are outlined with a border in the CAPACITY HEATMAP view. This setting helps to visually emphasize the days and hours during which most users are using system resources.
From the portlet frame, click to access the PREFERENCES view.
Configuring the Work Week and Shift
Use the Work week and shift tab in the PREFERENCES view to outline specific work days and hours with a dark gray border in the CAPACITY HEATMAP view. The work-week-andshift-border helps you easily identify the days and hours when system resources are used most.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Work week and shift tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select the number of shifts (work days) per week from the Total number of shifts per
week list.
A single row displays for each shift.
For each shift, click the appropriate arrow, and then select the following:
• Start day
• Start time
• Shift duration
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Teradata Viewpoint User Guide 117
Chapter 11 Capacity Heatmap
Capacity Heatmap
7
Click OK.
Example with Overlapping Shifts
When multiple shifts are defined on the same day and the hours you specify overlap, they are combined into one shift and are enclosed in one set of shift-indicator lines. The first shift starts at 6
AM and lasts for 8 hours, and the second shift starts at 1 PM and lasts for 8 hours. After you save these settings, the work-week lines and shift-indicator lines show a single shift from 6 AM to 9 PM.
The Work week and shift tab counts the combined Total number of shifts per week and the Shift
duration indicates a longer single shift.
118 Teradata Viewpoint User Guide
CHAPTER 12
External Content
External Content
The EXTERNAL CONTENT portlet allows you to access your company browser-based tools from within the Teradata Viewpoint portal. Upon opening the EXTERNAL
CONTENT portlet, the web page appears, as set by the Teradata Viewpoint Administrator.
If you have the appropriate permissions, you can use the PREFERENCES view to change the URL.
Caution: Any valid web URL can be used. However, the portlet does not validate page content.
Accessing some URLs might display the page outside the portlet or redirect the portal page entirely.
About the Preferences View
The PREFERENCES view allows you to customize the URL that appears when the
EXTERNAL CONTENT portlet is opened. You must have the appropriate permissions to change the URL.
Changing the URL
Use the PREFERENCES view to change the URL set by the Teradata Viewpoint Administrator.
1 From the portlet frame, click to access the PREFERENCES view.
2
3
4
Enter the URL of your choice.
Press Enter.
A confirmation message appears.
Click Save.
The new URL is saved.
Teradata Viewpoint User Guide 119
Chapter 12 External Content
External Content
Setting the Default URL
Use the PREFERENCES view to change the default URL set by the Teradata Viewpoint
Administrator.
1 From the portlet frame, click to access the PREFERENCES view.
2
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
The URL reverts back to the default URL set by the Teradata Viewpoint Administrator.
Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Enter the URL of your choice.
Click OK.
A confirmation message appears.
Click Save.
The new URL is saved as the default URL.
120 Teradata Viewpoint User Guide
CHAPTER 13
Lock Viewer
Lock Viewer
The LOCK VIEWER portlet allows you to view the lock data such as transaction identifiers, session identifiers, lock object identifiers, and global deadlocks. Viewing lock information helps you determine whether system performance has been degraded by a database lock.
Locate locks:
• In a specific database
• In a specific time frame
• Caused by a specific user
• That are blocking a specific user
About the Lock Viewer View
The LOCK VIEWER view provides a report containing information about the database locks that have occurred in the last 5 minutes, hour, day, or week. Lock data is displayed in the report only after the lock contention is resolved. Real-time lock contention data is not available.
Note: The Teradata Viewpoint Administrator must enable the appropriate collectors to display data in the LOCK VIEWER view.
The following list describes the features in this view:
Selection
Menus
Filters
Lock Log
Report
Shows the system and time frame for which the lock information is collected. You can choose a different system and time frame.
You can use the rewind feature with any time frame selection to retrieve lock data and compare it to data for a different date and time. You can only use the 5 minutes time frame with the rewind feature, and it is typically used to troubleshoot lock contentions.
Changes the displayed data to only show rows that match your filter criteria.
You can use the filters to search for locks in a specific database, caused by a specific user, or that are blocking a specific user.
Shows lock data for transaction identifiers, session identifiers, lock object identifiers, and global deadlocks.
Teradata Viewpoint User Guide 121
Chapter 13 Lock Viewer
Lock Viewer
Selecting a System and Time Frame
You can use selection menus above the filter to choose a system and time frame, starting with the highest level menu on the far left.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
Select a system from the menu.
Click Next
Select a time frame from the SELECT TIME FRAME dialog box.
122
5
Click Next
Teradata Viewpoint User Guide
Chapter 13 Lock Viewer
Lock Viewer
The report appears in the summary view.
Viewing the Lock Log Report
Use the Lock Log Report to view the lock data such as transaction identifiers, session identifiers, lock object identifiers, and global deadlocks.
1
In the selection menu, choose a system and a time frame.
2
The Lock Log report appears with the database locks that occurred within the period of time you specified.
Note: Lock data is displayed in the report only after the lock contention is resolved. Realtime lock contention data is not available.
[Optional] Drag the column border in either direction to resize the column.
Summary Locks
This topic describes the information that appears in the Lock Log Report.
Column Description
BLOCKING HOST Logical host ID of the transaction that imposed the lock
BLOCKING
LEVEL
Lock level of the transaction that imposed the lock. The following values indicate the level:
• Database Locked at the database level
• Table Locked at the table level
• RowHash Locked at the row level
• RowRange Locked for a range of rows
BLOCKING
MODE
BLOCKING
SESSION
Lock level mode of the transaction that imposed the lock. The following values indicate the mode:
• Ac Access
• Ex Exclusive
• Rd Read
• Wr Write
Session number of the transaction that imposed the lock. The following session numbers are used to indicate database internal sessions:
• 0 System User
• 1 System Accounting
• 2 System Recovery
Type
Number
Alpha
Alpha
Number
Teradata Viewpoint User Guide 123
Chapter 13 Lock Viewer
Lock Viewer
Column Description
• 3 Archive/Restore
BLOCKING USER Username who is blocking the query of another user
BLOCKTIME Date and time at which the block occurred, in MM/DD/YY
HH:MM:SS format
DATABASE Database name on which the lock was requested
Type
Alpha
Number
DEADLOCK
DELAY
HOST
LEVEL
Indicates whether the lock contention results in a deadlock. The following values indicate the type of deadlock:
• N No deadlock
• Y Local deadlock
• G Global deadlock
Total time the transaction waited for the block in seconds.
Logical host ID of the transaction that was waiting for the lock
Lock level of the transaction that was waiting for the lock. The following values indicate the level:
• Database Locked at the database level
• Table Locked at the table level
• RowHash Locked at the row level
• RowRange Locked for a range of rows
MODE
MULTIPLE
BLOCKER
Lock level mode of the transaction that was waiting for the lock.
The following values indicate the mode:
• Ac Access
• Ex Exclusive
• Rd Read
• Wr Write
Indicates whether more than one transaction encountered the same lock contention. The following values indicate the status:
• Y Two or more blocked transactions
• N One blocked transaction
PROCESSOR ID Identifier of the AMP where the lock was requested
SESSION Session number of the transaction that was locked. The following session numbers are used to indicate database internal sessions:
• 0 System User
• 1 System Accounting
• 2 System Recovery
TABLE Table name on which the lock was requested
Alpha or
Number
Alpha
Number
Number
Alpha
Alpha
Alpha
Number
Number
Alpha or
Number
124 Teradata Viewpoint User Guide
Chapter 13 Lock Viewer
Lock Viewer
Column
USER
Description
Username whose query is blocked by another user
Type
Alpha or
Number
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can also use filters to set thresholds. When thresholds are exceeded, the values are highlighted in the table view. You can sort the information in the columns. Filtering allows you to:
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filter Symbols
Use a symbol in the filter to search for words that have spelling variations or contain a specific pattern of characters. Do not use quotation marks in the filter.
*
?
Symbol
=
Description
Matches alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search. This search results are not case sensitive.
Matches zero, one, or multiple alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search.
This symbol can be used in conjunction with any other symbol.
Type this symbol at the beginning of your search to match alpha or numeric characters literally. Search results are case sensitive.
This symbol can be used in conjunction with the *, ?, and \.
cat?
?cat
cat?l
cat???
p???er
Example of Input Highlighted Results
cats, catalog
scat, Scatter
catalog
catalog
packer, parser, proper
*cat cat*l cat*
*ews*er
*%
=CAT
=cat?
=Cat*
cat, cats, catalog, scatter, wildcat
catalog
cat, cats, catalog newscaster, newsletter, newspaper what's 100%?
CAT
cats
Cat, Cats, Catalog
Teradata Viewpoint User Guide 125
Chapter 13 Lock Viewer
Lock Viewer
\
Symbol
>
<
Description
Type this symbol in front of a wildcard character so the wildcard is interpreted as a regular character and not as a wildcard.
This symbol can be used in conjunction with =, ?, &, and *.
Matches any numeric value that is greater than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only > and the number.
Matches any numeric value that is less than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only < and the number.
Example of Input Highlighted Results
=Cat_
=Cat\?
*\?
=cat\* cat\?
Cat_
Cat?
what's 100%? cat*
cat?, Cat?
>60 61, 62, 63, 64, and so forth
<60 59, 58, 57, 56, and so forth
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2
3
To clear all filter boxes all at one time, mouse over the filter .
The filter icon changes to .
Click .
126
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, set thresholds, and change the column display order. In the table, you can resize columns.
1
2
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
Teradata Viewpoint User Guide
Chapter 13 Lock Viewer
Lock Viewer
3
4
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click Set, type a threshold value, and click OK.
Values exceeding the threshold are highlighted and displayed in the table.
5
6
7
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
The thresholds and column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Teradata Viewpoint User Guide 127
Chapter 13 Lock Viewer
Lock Viewer
128 Teradata Viewpoint User Guide
CHAPTER 14
Metrics Analysis
Metrics Analysis
The METRICS ANALYSIS portlet allows you to analyze resource usage trends on one or more Teradata databases. Trends are graphed according to metrics such as CPU, memory, and throughput within a specified time range. The information is refreshed every 60 seconds.
The METRICS ANALYSIS view displays a graph with time on the horizontal axis, metric values on the vertical axis, and a different color for each metric sparkline. Sparklines show the average metric values as a line and have enhanced interactive features such as performance envelopes and information balloons that show the actual, minimum, and maximum metric values. Time-range buttons allow you to monitor current usage within the last hour or view usage trends over the last day, week, month, 3 months, or 6 months.
The PREFERENCES view allows you to select and organize metrics to display, set thresholds, and adjust the vertical axis range for each metric.
About the Metrics Analysis View
The METRICS ANALYSIS view provides a graph that represents Teradata Database resource usage. One or more Teradata databases can be monitored in the time range using the same or different metrics. Up to 10 metrics can be selected with different thresholds and vertical axis ranges. Each sparkline is assigned a color for every metric plotted in the graph.
Teradata Viewpoint User Guide 129
Chapter 14 Metrics Analysis
Metrics Analysis
130
The following list describes the features in this view:
Toolbar Contains the time-range buttons. Select a time-range button to change the graph.
Graph Plots the time range on the horizontal axis and the metric values on the vertical axis. The sparkline is a colored line that represents the average metric values.
Click a sparkline to see the highlighted sparkline and performance envelope. The performance envelope appears in a lighter shade of the sparkline color and represents the upper and lower metric values.
Metrics Lists the metrics that are defined in the PREFERENCES view. Each metric has a color and a checkbox. The metric name appears along with the name of the system being monitored if there is more than one system enabled. Select a metric name to see the sparkline highlighted and surrounded by the performance envelope in the graph.
About Metric Thresholds
Set thresholds to highlight metric values that are outside normal operating ranges. Set maximum vertical-axis ranges to limit the range of values displayed for selected metrics.
After a metric threshold is set in the PREFERENCES view, the threshold line is displayed across the graph with the threshold value to the right of the graph when you select a metric sparkline. As you mouse over the selected sparkline, information balloons display the data point value and the minimum and maximum performance envelope values. The sparkline and information balloons change to red when the threshold is exceeded during the time range. Threshold settings are optional and can be set any time after the metric has been configured.
Teradata Viewpoint User Guide
Chapter 14 Metrics Analysis
Metrics Analysis
Setting the Time Range
This task describes how to set the time range that is used to plot the graph.
1
In the toolbar, click a time-range button.
The portlet refreshes, and the graph is redrawn.
Removing Metrics from the Graph
This task describes how to disable metric sparklines.
1
Clear the color-coded checkbox on the metric line.
The metric sparkline disappears from the graph, but not from the list below the graph.
About the Toolbar
The toolbar allows you to choose the time range to display in the graph. The graph displays oldest data on the left and the most recent data on the right. For each metric, data is collected every 15 seconds and averaged according to the time range chosen.
Button
1 hour
Description
Displays the metric values for the last hour, plotted by minute.
Teradata Viewpoint User Guide 131
Chapter 14 Metrics Analysis
Metrics Analysis
Button
1 day
1 week
1 mo
3 mo
6 mo
Description
Displays the metric values for the last 24 hours, plotted by 15-minute periods.
Displays the metric values for the last week, plotted by hour.
Displays the metric values for the last month, plotted by 4-hour periods.
Displays the metric values for the last 3 months, plotted by 12-hour periods.
Displays the metric values for the last 6 months, plotted by day.
Clicking a different time-range button causes the portlet to immediately recalculate and update the graph based on the data points collected for the metrics.
Analysis Metrics
The following metrics are available to analyze resource usage.
System Metrics
Metric
Active Sessions
AMP CPU Skew
AMP I/O Skew
Average Outstanding
Disk Reqs
Description
Number of sessions with active queries
Type
Number
Comparison of CPU use on the busiest AMP to the average AMP Percent
Comparison of disk use on the busiest AMP to the average AMP Percent
Outstanding disk requests (disk queue size) Number
AWT
Components
Average number of AMP worker tasks in use on each AMP Number
Number of components, such as BYNETs or AMPs that are down
Number
CPU Average node CPU use
CPU AWT Processing CPU resources spent processing an AMP worker task
Percent
Percent
CPU/Disk Ratio
CPU Dispatcher
Processing
Ratio of CPU use to disk use
CPU resources spent in PE Dispatcher processing
Percent
Percent
DBC Disk Space
Disk I/O
Disk Reads
Disk Usage
Disk Writes
FSG Cache Miss
Host Block Reads
Host Block Writes
Index Ratio
Available DBC disk space in use
Number of disk I/Os
Percent
Number
Total physical disk reads per system during the sample period Number
Disk use on the system Percent
Total physical disk writes per system during the sample period Number
Physical I/Os divided by the logical I/Os Number
Message blocks (one or more messages sent in one physical group) received from all clients
Message blocks sent to all hosts
Index I/Os divided by the data block I/Os
Number
Number
Number
132 Teradata Viewpoint User Guide
Chapter 14 Metrics Analysis
Metrics Analysis
Metric
Logical MB/Second
Description
Logical I/O of the system in megabytes per second
Max Disk Space By AMP Available disk space currently in use
Max Spool Space By
AMP
Memory Failures
Available spool space in use
Memory Resources
Net A Usage
Net Reads
Net Writes
Node CPU Skew
Node CPU Usage
Memory failures across all nodes
Segments allocated to memory resources
Percent of BYNET A usage (BYNET receiver usage)
Reads from the BYNET during the sample period
Messages written to the BYNET during the sample period
Type
Number
Percent
Percent
Number
Number
Percent
Number
Number
Comparison of CPU use on the busiest node to the average node Percent
Average percent of CPU usage of all online nodes in the configuration
Percent
Node I/O Skew
Nodes Down
Parallelism
Parser Usage
PE CPU Usage
Comparison of disk use on the busiest node to the average node Percent
Number of system nodes down Number
Percentage of parallelism, calculated as the average CPU usage / maximum CPU usage x 100
Percent of CPU time the parser uses. It might exceed 100%
Average CPU usage of the PEs, calculated as the average usage of the parser and the dispatcher
Percent of I/O that are reads
Percent
Percent
Percent
Percent Read I/O
Session Login Count Sessions currently logged on to the system
Swap Drops Pages or segments dropped from memory during the sample period due to swapping
Swap Reads
Swap Writes
Pages or segments read into memory from the disk after a prior write or drop during the sample period
Pages or segments written into swap area from memory during the sample period
Number
Number
Number
Number
System CPU
Total AMP CPU
Total Disk Space
Total Node CPU
User CPU
Vproc CPU Usage
Wait I/O CPU
Average CPU time spent in System mode
Total AMP CPU use
Total disk space in use
Total node CPU use
Average CPU time spent in User mode
Average percent of the CPU usage of all online vprocs in the configuration
Average CPU time spent waiting for I/O
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Teradata Viewpoint User Guide 133
Chapter 14 Metrics Analysis
Metrics Analysis
Metric Colors
A fixed set of 10 colors is used for the sparkline, performance envelope, and information balloon. Each metric you select is listed below the graph, and its color is determined by the position selected in the PREFERENCES view.
5
6
3
4
7
8
9
10
Metric Position Color Example
1
2
Description
Green
Blue
Gold
Aqua
Pink
Gray
Lime
Brown
Teal
Purple
About the Preferences View
The PREFERENCES view allows you to customize the appearance of the graph.
In this view, you can:
• Add metrics to monitor and display.
• Delete metrics that you do not want to monitor or display.
• Select the ENABLE check box to plot the metric in the graph.
• Clear the ENABLE check box to remove the metric from the graph, but still list it below the graph.
• Reorder metrics to change their position and color.
• Select systems to monitor and display.
• Set a threshold that helps you track the performance of each metric.
• Set a vertical axis range to limit the maximum value to display.
From the portlet frame, click to access the PREFERENCES view.
Adding Metrics
This task describes how to add metrics that are plotted in the graph.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
134 Teradata Viewpoint User Guide
Chapter 14 Metrics Analysis
Metrics Analysis
3
4
5
6
7
8
9
10
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Click to add a metric.
Up to 10 metrics can be listed.
Select a metric from the METRIC list.
[Optional] Select a system from the SYSTEM list.
Note: The SYSTEM list is available when more than one Teradata Viewpoint server is enabled for the Data Collection Service.
[Optional] Enter a THRESHOLD value.
You can change the THRESHOLD settings for the metric at any time.
[Optional] Enter a VERTICAL AXIS RANGE value.
You can change the VERTICAL AXIS RANGE settings for the metric at any time.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Changing the Metrics Display Order
This task describes how to change the order of the metrics that are listed below the graph.
Reordering the metric list affects which color is assigned to the metric.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
3
4
5
[Optional] Click Clear Defaults to clear all default settings for this portlet.
On the metric row, click and drag the row to its new location.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Teradata Viewpoint User Guide 135
Chapter 14 Metrics Analysis
Metrics Analysis
6
Click OK.
Enabling and Disabling Metrics
This task describes how to enable and disable metrics from the graph. When a metric is disabled, the metric sparkline is not plotted in the graph; however, data points are still being collected, so the metric is included in the list under the graph and can be reactivated at a later time.
1
2
From the portlet frame, click to access the PREFERENCES view.
Select the Metrics tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do one of the following:
• Clear ENABLE on the metric line to disable the metric.
• Select ENABLE on the metric line to enable the metric.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Deleting Metrics
This task describes how to delete metrics from the graph. When a metric is deleted in the
PREFERENCES view, the metric sparkline is not plotted in the graph, and the metric is not included in the list under the graph.
1
2
3
4
From the portlet frame, click to access the PREFERENCES view.
Select the Metrics tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Click on the metric row of the metric you want to delete.
136 Teradata Viewpoint User Guide
Chapter 14 Metrics Analysis
Metrics Analysis
5
6
The metric row disappears.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 137
Chapter 14 Metrics Analysis
Metrics Analysis
138 Teradata Viewpoint User Guide
CHAPTER 15
Metrics Graph
Metrics Graph
The METRICS GRAPH portlet allows you to analyze resource usage trends on a Teradata
Database system within a specified time range to help identify daily or weekly periods when a system is either over-utilized or under-utilized. You can use this information to determine when to schedule resource-intensive jobs with minimal impact to other users.
The METRICS GRAPH view displays a graph with time on the horizontal axis and metric values on the vertical axis. The metric and system are selected using selection menus. Timerange buttons on the toolbar allow you to select 1-month or 3-month periods. The date range displayed can be adjusted dynamically using the date-range slider. The vertical scale for the metric values can be expanded or compressed by dragging the number up or down.
Each point on the graph represents the value collected for the selected metric during the preceding 1-hour period.
About the Metrics Graph View
The METRICS GRAPH view provides a graph of variations and trends in system resource usage. The graph plots the time range on the horizontal axis and the metric values on the vertical axis. Customize the view using the menus, toolbar, and date-range slider to select metrics and date ranges.
The following list describes the features in this view:
Selection
Menus
Toolbar
Shows the selections that define the metric currently being displayed. You can change the metric by changing the selections.
Contains the time-range buttons. Select a time-range button to change the graph. The time-range start and end dates are displayed on the toolbar next to the time-range buttons.
Date-Range
Slider
Controls the amount of historical data displayed in the view and adjusts to display from 2 days to approximately 4 months of historical data. Dates outside the date-range slider timeline are shaded lighter. The darker-shaded area between the slider handles represents the current date range being displayed.
Metric Value Shows the numerical value of metric on the vertical axis. Mouse over a number and drag it up or down to expand or compress the vertical scale.
Teradata Viewpoint User Guide 139
Chapter 15 Metrics Graph
Metrics Graph
Sparkline Displays metric data values in the graph. Mouse over a sparkline to see an information balloon containing the date and time the value was collected and the metric value.
140
Trend-Reporting Metrics
Database Metrics
Metric
Current Perm
Current Perm Max
Current Perm Min
Current Spool
Current Spool Max
Current Spool Min
Current Temp
Current Temp Max
Current Temp Min
Description
Sum of the current amount of permanent space (disk space) used across all vprocs
Maximum permanent space used on a single vproc
Minimum permanent space used on a single vproc
Sum of the current amount of spool space (disk space) used across all vprocs
Maximum spool space used on a single vproc
Minimum spool space used on a single vproc
Sum of the current amount of temporary space (disk space) used across all vprocs
Maximum temporary space used on a single vproc
Minimum temporary space used on a single vproc
Type
Number
Number
Number
Number
Number
Number
Number
Number
Number
Teradata Viewpoint User Guide
Chapter 15 Metrics Graph
Metrics Graph
Metric
Peak Perm
Peak Perm Max
Peak Perm Min
Peak Spool
Peak Spool Max
Peak Spool Min
Peak Temp
Peak Temp Max
Peak Temp Min
Perm Limit
Spool Limit
Temp Limit
Description
Sum of the largest amount of permanent space used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of permanent space used on a single vproc since the last reset
Minimum of the largest amount of permanent space used on a single vproc since the last reset
Sum of the largest amount of spool used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of spool used on a single vproc since the last reset
Minimum of the largest amount of spool used on a single vproc since the last reset
Sum of the largest amount of temporary space used across all vprocs since the last reset of the peak perm value
Maximum of the largest amount of temporary space used on a single vproc since the last reset
Minimum of the largest amount of temporary space used on a single vproc since the last reset
Maximum space available for permanent space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Maximum space available for spool space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Maximum space available for temporary space storage of all index tables, data tables, subtables, stored procedures, triggers, and permanent journals
Type
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Performance Metrics
Metric
Blocking Duration
Concurrency
Response Time
Retrieve Time
Rows Returned
Total Time
Description
Total time the heartbeat query is blocked
Average number of active tasks running on the Teradata
Database while the heartbeat query is running
Type
Number
Number
Average response time of the selected canary query
Average time to retrieve all results
Number
Number
Average number of rows returned by the selected canary query Number
Combined response time and retrieve time Number
Teradata Viewpoint User Guide 141
Chapter 15 Metrics Graph
Metrics Graph
Query Metrics
Metric
Abort Total
Active AMPs Avg
Active AMPs Max
Description
Number of aborted queries
Average number of active AMPs
Maximum number of active AMPs
Active AMPs Min
Active AMPs Stddev
Minimum number of active AMPs
Standard deviation of active AMPs
AMP CPU Skew Avg Average percent of AMP CPU skew
AMP CPU Skew Max Maximum percent of AMP CPU skew
AMP CPU Skew Min Minimum percent of AMP CPU skew
AMP CPU Skew Stddev Standard deviation percent of AMP CPU skew
AMP I/O Skew Avg
AMP I/O Skew Max
Average percent AMP I/O skew
Maximum percent AMP I/O skew
AMP I/O Skew Min Minimum percent AMP I/O skew
AMP I/O Skew Stddev Standard deviation of AMP I/O skew
Cache Total
Concurrency
Number of queries found in step cache
Average number of queries executing simultaneously during the hour
Delay Time Avg
Delay Time Max
Delay Time Min
Delay Time Stddev
First Response Time
Avg
First Response Time
Max
First Response Time
Min
First Response Time
Stddev
Average query delay time
Maximum query delay time
Minimum query delay time
Standard deviation of query delay time
Average time it takes to receive the first response
Maximum time it takes to receive the first response
Minimum time it takes to receive the first response
Number
Number
Number
Number
Number
Number
Number
Standard deviation of time it takes to receive the first response Number
Type
Number
Number
Number
Number
Number
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Number
Number
Max Steps in
Parallelism Avg
Max Steps in
Parallelism Max
Max Steps in
Parallelism Min
Average number of level-2 query steps executed in parallel
Maximum number of level-2 query steps executed in parallel Number
Minimum number of level-2 query steps executed in parallel
Number
Number
142 Teradata Viewpoint User Guide
Chapter 15 Metrics Graph
Metrics Graph
Metric
Max Steps in
Parallelism Stddev
Description
Standard deviation of number of level-2 query steps executed in parallel
Number of Steps Avg Average number of query steps
Number of Steps Max Maximum number of query steps
Number of Steps Min Minimum number of query steps
Number of Steps Stddev Standard deviation of number of query steps
Query Count Queries logged in dbc.QryLog, or the sum of Querycount from dbc.QryLogsummary during the sample period
Query Seconds Avg
Query Seconds Max
Average query run time
Maximum query run time
Query Seconds Min Minimum query run time
Query Seconds Stddev Standard deviation of query run time
Result Rows Avg
Result Rows Max
Result Rows Min
Result Rows Stddev
Average number of result rows
Maximum number of result rows
Minimum number of result rows
Standard deviation of number of result rows
Spool Usage Avg
Spool Usage Max
Spool Usage Min
Spool Usage Stddev
Steps with Parallelism
Avg
Steps with Parallelism
Max
Steps with Parallelism
Min
Steps with Parallelism
Stddev
Average amount of spool the query used
Maximum amount of spool the query used
Minimum amount of spool the query used
Standard deviation of amount of spool the query used
Average number of query steps with parallel steps
Maximum number of query steps with parallel steps
Minimum number of query steps with parallel steps
Type
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Number
Standard deviation of number of query steps with parallel steps Number
Number
Number
Number
Number
Number
Number
Number
Number
Total CPU Time Avg Average CPU time
Total CPU Time Max Maximum CPU time
Total CPU Time Min Minimum CPU time
Total CPU Time Stddev Standard deviation of CPU time
Total I/O Count Avg Average I/O count
Total I/O Count Max Maximum I/O count
Total I/O Count Min Minimum I/O count
Number
Number
Number
Number
Number
Number
Number
Teradata Viewpoint User Guide 143
Chapter 15 Metrics Graph
Metrics Graph
Metric Description
Total I/O Count Stddev Standard deviation of I/O count
Warning Total Total number of queries with warnings
Type
Number
Number
System Metrics
Metric
Active Sessions
AMP CPU Skew
AMP I/O Skew
Average Outstanding
Disk Reqs
Description
Number of sessions with active queries
Type
Number
Comparison of CPU use on the busiest AMP to the average AMP Percent
Comparison of disk use on the busiest AMP to the average AMP Percent
Outstanding disk requests (disk queue size) Number
AWT
Components
Average number of AMP worker tasks in use on each AMP Number
Number of components, such as BYNETs or AMPs that are down
Number
CPU Average node CPU use
CPU AWT Processing CPU resources spent processing an AMP worker task
Percent
Percent
CPU/Disk Ratio
CPU Dispatcher
Processing
Ratio of CPU use to disk use
CPU resources spent in PE Dispatcher processing
Percent
Percent
DBC Disk Space
Disk I/O
Disk Reads
Disk Usage
Available DBC disk space in use
Number of disk I/Os
Percent
Number
Total physical disk reads per system during the sample period Number
Disk use on the system Percent
Disk Writes
FSG Cache Miss
Host Block Reads
Total physical disk writes per system during the sample period Number
Physical I/Os divided by the logical I/Os Number
Total message blocks (one or more messages sent in one physical group) received from all clients
Total message blocks sent to all hosts
Number
Number Host Block Writes
Index Ratio
Logical MB/Second
Index I/Os divided by the data block I/Os
Logical I/O of the system in megabytes per second
Max Disk Space By AMP Available disk space currently in use
Max Spool Space By
AMP
Available spool space in use
Number
Number
Percent
Percent
Memory Failures
Memory Resources
Net A Usage
Total memory failures across all nodes
Total segments allocated to memory resources
Percent of BYNET A usage (BYNET receiver usage)
Number
Number
Percent
144 Teradata Viewpoint User Guide
Chapter 15 Metrics Graph
Metrics Graph
Metric
Net Reads
Net Writes
Description
Total reads from the BYNET during the sample period
Type
Number
Total messages written to the BYNET during the sample period Number
Node CPU Skew
Node CPU Usage
Node I/O Skew
Nodes Down
Parallelism
Parser Usage
PE CPU Usage
Comparison of CPU use on the busiest node to the average node Percent
Average percent of CPU usage of all online nodes in the configuration
Percent
Comparison of disk use on the busiest node to the average node Percent
Number of system nodes down Number
Percentage of parallelism, calculated as the average CPU usage / maximum CPU usage x 100
Percent of CPU time the parser uses. It might exceed 100%
Average CPU usage of the PEs, calculated as the average usage of the parser and the dispatcher
Percent of I/O that are reads
Percent
Percent
Percent
Percent Read I/O
Session Login Count Sessions currently logged on to the system
Swap Drops Total pages or segments dropped from memory during the sample period due to swapping
Swap Reads
Swap Writes
Total pages or segments read into memory from the disk after a prior write or drop during the sample period
Total pages or segments written into swap area from memory during the sample period
Number
Number
Number
Number
System CPU
Total AMP CPU
Total Disk Space
Total Node CPU
User CPU
Vproc CPU Usage
Wait I/O CPU
Average CPU time spent in System mode
Total AMP CPU use
Total disk space currently in use
Total node CPU use
Average CPU time spent in User mode
Average percent of the CPU usage of all online vprocs in the configuration
Average CPU time spent waiting for I/O
Percent
Percent
Percent
Percent
Percent
Percent
Percent
Table Metrics
Metric
Index Count
Table Size
Description
Total number of indexes
Table size in bytes, including index, fallback, and journal subtables
Type
Number
Number
Teradata Viewpoint User Guide 145
Chapter 15 Metrics Graph
Metrics Graph
About the Metrics Graph Menus and Toolbar
The menus and toolbar allow you to specify the display attributes of the METRICS GRAPH view.
146
Use the selection menus to define a metric to monitor by selecting a:
• System
• Category
• Metric
• Source or Variant
Note: The first time you add the portlet to the page, the first available metric that you have permission to view is displayed. However, if you only have permission to view Table metrics, no data appears in the portlet until you select a metric using the selection menus.
The 1 mo and 3 mo buttons allow you to adjust the time range displayed. When clicked, 1 month or 3 months of data up to the current end date appears in the view. As you adjust the time range, the toolbar refreshes automatically to display the new time range in the toolbar.
Selecting Metrics and Systems to Monitor
You can use selection menus above the toolbar to choose a metric and system to monitor in the portlet, starting with the highest level menu on the far left. Different menus choices are available based on the previous menu, so not all menus apply to all metrics.
Note: You are not required to make a selection from every menu each time you modify a metric selection.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
5
6
7
8
Select a system from the menu.
Click Next.
Select a category from the menu.
Click Next.
Select a metric from the menu.
Click Next.
[Optional] Select a source or variant from the menu.
Note: The menu for source or variant (sum, average, minimum, maximum, standard deviation of that metric) is only available for certain metric categories.
Teradata Viewpoint User Guide
Chapter 15 Metrics Graph
Metrics Graph
9
Click Next.
Adjusting the Date Range
Use the toolbar to set the range of dates to display for the selected metric and system.
1
Mouse over the date-range slider to activate the start-date and end-date handles.
2
Drag the start-date handle until the intended start date is displayed in the toolbar (upper left).
3
4
5
6
Drag the end-date handle until the intended end date is displayed in the toolbar.
[Optional] Drag the date-range slider left or right to move the start-date and end-date handles in unison.
[Optional] Click 1 mo.
One month of historical data is displayed ending at the current end date.
[Optional] Click 3 mo.
Three months of historical data is displayed ending at the current end date.
Teradata Viewpoint User Guide 147
Chapter 15 Metrics Graph
Metrics Graph
148 Teradata Viewpoint User Guide
CHAPTER 16
My Queries
My Queries
The MY QUERIES portlet allows you to view and manage your queries across multiple
Teradata Database systems. You can see if queries are queued or blocked, and you can see their impact on system resources.
Use the MY QUERIES portlet to view information about queries in either the summary view or the details view. The summary view contains a table with one row allocated to each of the sessions logged on under one or more user names. Select a row in the summary view to see additional session and query information in the details view. Use the SQL, Explain,
Blocked By, or Query Band tab in the details view to display information for the selected session.
The PREFERENCES view allows you to select one or more Teradata Database systems, and then select one or more users per system to monitor. From this view, you can also select a format for the SQL that appears in the query details view.
About the My Queries View
The MY QUERIES view displays queries running on one or more Teradata Database systems, displaying sessions running under your logon.
After you add an account in the PROFILE portlet for each system you want to monitor, your queries display in the MY QUERIES portlet.
The MY QUERIES view provides information about each session in a table, with columns configured specifically for the current view. These statistics are sampled and the table is refreshed every 30 seconds. Highlighted values in any row indicate that a session has exceeded threshold criteria for a specific metric. Click anywhere in a row to see session details.
The portlet allows you to filter and sort to find the queries you want.
Teradata Viewpoint User Guide 149
Chapter 16 My Queries
My Queries
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can also use filters to set thresholds. When thresholds are exceeded, the values are highlighted in the table view. You can sort the information in the columns. Filtering allows you to:
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filter Symbols
Use a symbol in the filter to search for words that have spelling variations or contain a specific pattern of characters. Do not use quotation marks in the filter.
?
Symbol Description
Matches alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search. This search results are not case sensitive.
cat?
?cat
cat?l
cat???
p???er
Example of Input Highlighted Results
cats, catalog
scat, Scatter
catalog
catalog
packer, parser, proper
150 Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
\
*
Symbol Description
Matches zero, one, or multiple alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search.
This symbol can be used in conjunction with any other symbol.
=
>
Type this symbol at the beginning of your search to match alpha or numeric characters literally. Search results are case sensitive.
This symbol can be used in conjunction with the *, ?, and \.
Type this symbol in front of a wildcard character so the wildcard is interpreted as a regular character and not as a wildcard.
This symbol can be used in conjunction with =, ?, &, and *.
Matches any numeric value that is greater than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only > and the number.
Example of Input Highlighted Results
*cat cat*l cat*
*ews*er
*%
cat, cats, catalog, scatter, wildcat
catalog
cat, cats, catalog newscaster, newsletter, newspaper what's 100%?
=CAT
=cat?
=Cat*
=Cat_
=Cat\?
CAT
cats
Cat, Cats, Catalog
Cat_
Cat?
*\?
=cat\* cat\?
what's 100%? cat*
cat?, Cat?
>60 61, 62, 63, 64, and so forth
< <60 59, 58, 57, 56, and so forth Matches any numeric value that is less than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only < and the number.
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2
3
To clear all filter boxes all at one time, mouse over the filter .
The filter icon changes to .
Click .
Teradata Viewpoint User Guide 151
Chapter 16 My Queries
My Queries
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, set thresholds, and change the column display order. In the table, you can resize columns.
1
2
3
4
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click Set, type a threshold value, and click OK.
Values exceeding the threshold are highlighted and displayed in the table.
152
5
6
7
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
The thresholds and column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Summary View Metrics
Metrics appearing in the summary view can be selected using the Columns dialog box.
Metrics available for monitoring and display are listed below.
Metric
ACCOUNT
BLOCKED TIME
CPU SKEW
CPU USE
Delta CPU
Delta I/O
DURATION
HOST
Description
Account from which a query was submitted
How long the query has been blocked
CPU skew during the last sample
Type
Character
Number
Percent
Percent of the total amount of available CPU used by the query Percent
Total CPU usage time consumed, in seconds, since the last sample
Number
I/O count since the last sample
How long the query has been running
Number of host systems
Number
Number
Number
Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
Metric
IMPACT CPU
IN STATE
I/O SKEW
PARTITION
PJI
Description
Total CPU seconds consumed across all AMPs that are active for this session
How long the query has been in the current state
I/O skew during the last sample
Partition in which the query is running
Ratio of the CPU milliseconds per I/O for the query, where a larger Product Join Index number indicates system performance degradation
Number of CPU seconds needed to run the query REQ CPU
REQ I/O
SESSION ID
SPOOL
START
STATE ICON
STATE
SYSTEM
TEMP SPACE
Number of disk I/Os performed to run the query
Unique session identifier
Amount of spool space the query requires
Time that the query started running on Teradata Database
Icon representing the current state of the query
Text describing the current state of the query
Full name of the system running the query
Amount of temp space used by the query
UNNECESSARY I/O All AMP I/O divided by all AMP CPU, displayed in milliseconds, to reveal large amounts of I/O occurring over a short period of time
USERNAME Name of the user who submitted the query
WORKLOAD Workload in which the query is running
Type
Number
Number
Percent
Character
Number
Character
Character
Number
Number
Number
Number
Number
Icon
Character
Character
Number
Number
Symbol Reference
The following symbols appear in summary and details views:
Symbol Name Definition
ABORTING Query has been aborted, and changes are being rolled back.
ACTIVE
BLOCKED
Query is running.
Query is waiting for a lock held by another query.
DELAYED
IDLE
OTHER
PARSING
Query is in a delay queue waiting to run.
No query is running.
Query is in an unknown state.
Query is being parsed before running.
QTDELAYED Query is waiting for rows to be inserted into a queue table.
RESPONSE Query is returning results to the user.
Teradata Viewpoint User Guide 153
Chapter 16 My Queries
My Queries
Symbol Name Definition
SESDELAYED Query is delayed because a utility limit has been exceeded in FastLoad,
MultiLoad, FastExport, or ARC.
About the Details View
The details view provides statistics and information about the selected session. This view can be accessed by clicking on a session row in the summary view.
When viewing a request, you can see detailed information from the following tabs:
Overview Key statistics for a session. Any value exceeding the thresholds is highlighted.
SQL SQL for the selected query.
Explain Explain steps for the query, including step statistics and explain text.
Blocked By Details about other queries that are blocking this query.
Note: This tab is available when the selected query is blocked.
Query Band Displays the query band name and value for the selected query.
Use the Next and Previous buttons to move through sessions without returning to the summary view.
154
Details View Metrics
Query Information
Metric
STATE
Description
Query state, such as ACTIVE, BLOCKED, TERMINATE
Type
Character
Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
Metric
TIME IN STATE
Description
How long the query has been in the current state, displayed as
HH:MM:SS
TOTAL DURATION How long the query has run, displayed as HH:MM:SS
CPU
CPU delta
Total CPU usage time, in seconds, consumed by the query
Total CPU usage time consumed, in seconds, since the last sample
I/O
I/O delta
Number of I/O operations the query performed
I/O count since the last sample
UNNECESSARY I/O All AMP I/O divided by all AMP CPU, displayed in milliseconds, to reveal large amounts of I/O occurring over a short period of time
IMPACT CPU Total CPU seconds consumed across all AMPs that are active for this session
CPU SKEW
I/O SKEW
SPOOL
TEMP SPACE
WORKLOAD
PJI
CPU USE
CPU skew during the last sample
I/O skew during the last sample
Amount of spool space the query is using
Amount of temp space the query is using
Workload where the query is actively running
Ratio of the CPU milliseconds per I/O for the query, where a larger Product Join Index number indicates system performance degradation
Type
Number
Number
Number
Number
Number
Number
Number
Number
Percent
Percent
Number
Number
Character
Number
Percent of the total amount of available CPU used by the query Percent
Session Information
Metric
USER
ACCOUNT
SOURCE
PARTITION
REQUESTS
Description
Name of the user who submitted the query
Account of the user who submitted the query
Source details, such as application name, IP address, and host user name
Partition in which the query is running
Number of queries submitted by the session
Type
Character
Character
Character
Character
Number
About the Details Overview Tab
The Overview tab provides detailed information about key metrics for the selected session and its queries. The metric values displayed provide a snapshot of Teradata Database system status. Metrics that exceed preset thresholds are highlighted. Under SESSION INFO, you can click on a user or account to see all sessions for that user or account string.
Teradata Viewpoint User Guide 155
Chapter 16 My Queries
My Queries
About the Details SQL Tab
The SQL tab displays the SQL for the selected query. This information is read-only.
156
About the Details Explain Tab
The Explain tab displays an abbreviated version of the Step statistics and the Explain text that result from an Explain request in an SQL session. This information is read-only, and no actions are available from this tab. The Explain tab displays completed steps at the top of the list and future steps at the bottom. The tab periodically refreshes to display updated information. Each Explain step is uniquely identified with a number where the background of the number box indicates status.
Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
• Completed steps are at the top of the list and indicated by a black number box.
• Active steps are indicated by a pulsating number box (flashes gray and white).
• Steps to run are at the bottom of the list and indicated by a white number box.
Each numbered step includes:
EST. TIME
EST. I/O
Estimated execution time for the step.
Estimated number of I/Os for the step.
ACTUAL TIME Actual CPU time consumed by the step, or blank if the step has not run.
ACTUAL I/O Actual number of I/Os for the step, or blank if the step has not run.
About the Details Blocked By Tab
The Blocked By tab displays details about other queries that are blocking this query. This information is read-only, and no actions are available from this tab. If this tab is unavailable, the selected query is not blocked. The Blocked By tab displays:
USERNAME Name of the user that is running the query that holds the lock.
HOST Host ID that is logged on to the session.
SESSION ID Session ID in which the blocking query was run.
LOCK TYPE Type of lock.
STATUS
LOCKED
Lock status.
Name of the locked object.
Teradata Viewpoint User Guide 157
Chapter 16 My Queries
My Queries
About the Details Query Band Tab
The Query Band tab displays the query band name and value for the selected query. This information is read-only. For each query, the QUERY BAND tab displays:
NAME
VALUE
The name of the query band.
The value of the query band.
About the Tools Menu
The Tools menu allows you to manage queries and sessions.
158
Use the Tools menu to balance system resources:
Abort
Change Priority
Abort the selected query or session.
Change the priority of the selected query or session.
Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
Change Workload
Release Query
Change the workload of the selected query or session.
Release the selected query from a delay queue.
You must log in with a user ID that has permission to abort, change priorities or workloads, or release queries. If you log out, close a portlet, or open a new portlet instance, you must log in again.
Note: If Teradata Active System Management (TASM) is enabled, Change Workload is available from the Tools menu. If TASM is disabled, Change Priority is available from the menu. If you do not see Change Workload or Change Priority in the menu, the system you are monitoring does not support these features or you do not have permission to use them.
If the query you are monitoring is delayed, only Release Query is available.
Aborting a Query or a Session
This task describes how to abort a query or a session of queries that is blocking other queries or consuming too many resources.
1
2
3
4
5
6
7
From the summary view, click the row of the query you want to abort.
Click Tools > Abort.
[Optional] Log in.
Click Next.
Select one of the following:
• Abort Query to abort the selected query.
• Abort Session to abort the selected query and log off the session.
Click Next.
Click Next to confirm your selection.
Changing the Priority of a Query or Session
This task describes how to change the priority of a query or session to allow higher priority queries to run or to balance session resources.
Note: This menu item is only available when workloads are not enabled and the system being monitored supports this feature.
1
2
3
4
5
6
7
8
From the summary view, click the row of the query with a priority that needs to change.
Click Tools > Change Priority.
[Optional] Log in.
Click Next.
From the list of accounts that have been assigned to the user, select an account to copy the account name to the Edit new account string box.
[Optional] Edit the account string or enter a new account string.
Click Next.
Select one of the following:
Teradata Viewpoint User Guide 159
Chapter 16 My Queries
My Queries
9
10
• Move just this query to change the priority of the selected query.
• Move this query and all future queries associated with this session to change the priority of the selected query and all subsequent queries in the current session.
Click Next.
Click Next to confirm your selection.
Changing the Workload of a Query or Session
This task describes how to change the workload of a query or session to either allow higher priority workloads to run or to balance workload resources.
Note: This menu item is only available when workloads are enabled and the system being monitored supports this feature.
1
2
3
4
5
6
7
8
9
From the summary view, click the row of the query with the workload that needs to change.
Click Tools > Change Workload.
[Optional] Log in.
Click Next.
[Optional] Select a different workload from the list.
Click Next to confirm your selection.
Select one of the following:
• Move just this query to change the workload of the selected query.
• Move this query and all future queries associated with this session to change the workload of the selected query and all subsequent queries in the same session.
Click Next.
Click Next to confirm your selection.
Releasing a Query
This task describes how to release a query that is queued and waiting to run.
1
2
3
4
5
From the summary view, click the row of the query you want to release.
Click Tools > Release Query.
[Optional] Log in.
Click Next.
Click Next to confirm your selection.
Changing Multiple Sessions
You can change system resources for multiple sessions, users, or account strings in the following locations:
• All sessions table from the summary view
• User sessions table from the details view
• Account strings table from the details view
160 Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
1
2
Click on a session from the summary view.
[Optional] Access user or account string tables from the details view.
a b
Click on a session.
Click the USER or ACCOUNT link under SESSION INFO.
3
4
5
6
7
Select an action from the Tools menu.
Check boxes appear next to the sessions.
Do one of the following:
• Select the check box in the column heading to select all sessions.
• Select the check boxes for specific sessions.
Select Submit.
[Optional] Log in.
Follow the instructions on subsequent screens.
About the Preferences View
The PREFERENCES view allows you to select systems and users to monitor and to select a format for the SQL that appears in the query details view.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
Systems Select the Teradata Database systems and login user names to monitor.
Display Choose formatted or unformatted SQL to display on the SQL tab of the query details view.
Selecting Systems and Users to Monitor
Use the Systems tab in the PREFERENCES view to select Teradata Database systems and login user names to monitor.
Define user names for each system using the PROFILE portlet. Only predefined user names appear on the Systems tab.
1
2
3
From the portlet frame, click to access the PREFERENCES view.
Click the Systems tab.
Click to expand system names and show available user names.
Teradata Viewpoint User Guide 161
Chapter 16 My Queries
My Queries
4
5
6
7
[Optional] Click Clear Defaults to clear all default settings for this portlet.
For each Teradata Database system and user name you want to monitor: a
Select the systems on which you want to monitor queries.
b
Select the user names for each system that you want to monitor.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Selecting Display Options
The Display tab in the PREFERENCES view allows you to format the SQL that appears on the SQL tab of the query details view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Display tab.
162
3
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Teradata Viewpoint User Guide
Chapter 16 My Queries
My Queries
4
5
6
Do one of the following:
• Select the Format SQL check box to use formatted SQL.
• Clear the Format SQL check box to use unformatted SQL.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 163
Chapter 16 My Queries
My Queries
164 Teradata Viewpoint User Guide
CHAPTER 17
Node Resources
Node Resources
The NODE RESOURCES portlet allows you to monitor physical and virtual resources to locate over or under-utilized resources and isolate performance or system problems. You choose which system and resources to monitor on your Teradata system.
The NODE RESOURCES portlet provides metrics about:
• Percentage of CPU used by nodes or vprocs
• How system resource usage is spread across the vprocs
• How much physical disk I/O, BYNET traffic, or host reads and writes are occurring
• Whether congestion or excessive swapping is a problem on a single or group of nodes or vprocs
These metrics allow you to analyze data and detect problems such as poor node or vproc parallel efficiency, or higher than expected disk read/write ratio or swap I/O rate.
The NODE RESOURCES portlet provides controls that let you choose what information is displayed. The information is refreshed every 60 seconds.
The PREFERENCES view allows you to choose which metrics appear in the portlet views.
About the Summary Views
The summary views provide a status of the resources on your Teradata system so you can monitor and locate issues. The NODES summary view displays the status of nodes, grouped by clique. The VPROCS summary view displays the status of vprocs in a node.
The following list describes the features in these views:
Selection
Menus
Toolbar
Preview
Sliders
Resource
Totals
Shows the system and resources currently being displayed. Choose a system, including multi-generational systems, and type of node.
Contains a count of the total resources on the selected system, the number of resources outside the threshold, and the number of down resources that are out of service or offline.
Displays resources that are outside the threshold or down. You can customize the metrics displayed from the PREFERENCES view.
Displays the total number of nodes or vprocs that are outside the threshold.
Teradata Viewpoint User Guide 165
Chapter 17 Node Resources
Node Resources
Clique ID
Node ID
Preview
Squares
Displays the status of nodes, grouped by clique, when you select any of the
Nodes views from the selection menus.
Displays the status of vprocs in a node when you select any of the Vprocs views from the selection menus. You can click a node ID to view the details view for that node.
Displays node or vproc status by color-coded squares, depending on the resource you chose from the selection menus.
Following is an example of the NODES summary view that you see when you select All
Nodes > Nodes > ALL from the selection menu.
Following is an example of the VPROCS summary view that you see when you select All
Nodes > Vprocs > ALL from the selection menu.
166 Teradata Viewpoint User Guide
Chapter 17 Node Resources
Node Resources
Selecting a System to Monitor
You can use selection menus above the toolbar to choose a system and type of resource to monitor in the portlet, starting with the highest level menu on the far left. Different menu choices are available based on the previous menu.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
5
6
7
8
9
Select a system from the menu.
Click Next.
Select a type of resource from the menu.
Click Next.
Select Nodes or Vprocs from the menu.
Click Next.
Do one of the following:
• Select Nodes, and then select ALL, With AMPs, or Without AMPs from the menu.
• Select Vprocs, and then select ALL, AMPs, or PEs from the menu.
[Optional] Click Next.
Selection Menu Choices
The NODE RESOURCES portlet displays data for a single Teradata system. The selection menu allows you to choose the type of data that appears in the summary views, preview
Teradata Viewpoint User Guide 167
Chapter 17 Node Resources
Node Resources squares, and details views. Depending on your system, you may have access to multigenerational systems.
Selection Menu Choices Description
Nodes > ALL Node data on all nodes, grouped by clique
Nodes > With AMPs Node data on all nodes with AMPs, grouped by clique
Nodes > Without AMPs Node data on all nodes without AMPs, grouped by clique
Vprocs > ALL
Vprocs > AMP
Vproc data on all AMPs and vprocs, grouped by node
Vproc data only on AMPs, grouped by node
Vproc data only on PEs, grouped by node Vprocs > PE
5500H, 5350, 4980, and so forth
Multi-generational system data
For example, by selecting 5500H, you can view and compare data for
5500H nodes within a system. Typically, you would not compare metrics on older hardware with metrics on newer hardware.
About the Toolbar
The toolbar allows you to filter the display attributes in the table view by using the resource count status buttons. The toolbar displays a summary count of:
• The total resources on the selected system
• The > threshold resources that are outside the threshold
• The number of down resources that are out of service or offline
After you click on any button, the table view appears with statistics and information about the selected resources to help you isolate issues.
168
About the Preview Sliders
Preview sliders display metrics of resources that are outside the threshold or down and help you determine if there is skew across the nodes or vprocs. The metrics and thresholds that appear in the preview sliders are set in the PREFERENCES view.
As you move a slider:
• A box to the right of each slider displays the total number of nodes or vprocs that are outside the threshold.
• A box above the slider displays a percentage + or - from the average. The left side of the slider represents the average. As you move the slider to the right, the metric is further away from the average.
• Preview squares reflect the resources that are outside the threshold.
You can click a node ID to view the details view for that node.
A single vproc might be counted for each resource total, however, that vproc is only counted once in the > threshold status button.
Teradata Viewpoint User Guide
Chapter 17 Node Resources
Node Resources
About the Preview Squares
Preview squares are color-coded squares that help you determine status for a particular resource. Preview squares display data in the summary views and details views according to the resources selected from the selection menu.
Mouse over a preview square to display an information balloon containing the metrics for the resource selected. The information in the balloon corresponds to the metrics in the 3 preview sliders. Click a preview square to see the details view for that resource.
The following table describes the meaning of the preview squares.
Preview Square
Gray
Orange
Black
Status
Normal
Warning
Down
Description
No threshold is set or no metric is outside of the threshold.
At least one metric for a resource is outside the threshold.
Set automatically when the resource goes down or when the Teradata Database Administrator takes the resource out of service or offline.
Summary View Metrics
Select metrics to appear in the summary view for nodes, vprocs, AMPs, and PEs using the
Columns dialog box. Some metrics are only available in certain views.
N Nodes > ALL, Nodes > With AMPs, Nodes > Without AMPs
V Vprocs > ALL
A Vprocs > AMP
P Vprocs > PE
Teradata Viewpoint User Guide 169
Chapter 17 Node Resources
Node Resources
Metric
CIC USAGE
CPU USAGE
DISK I/O
DISK OUT REQ
AVG
Description
Percent of Channel Interface Controller usage for this resource
Type
Percent
Percent of CPU usage that is spent being active (not idle) Percent
Number of disk I/Os
Average number of outstanding disk requests for this resource
View
N
N, V, A, P
Number N, V, A
Number N, V, A
DISK READS Total number of physical disk reads for this resource during the sample interval
DISK USAGE Disk usage for this resource
DISK WRITES Total number of physical disk writes for this resource during the sample interval
HOST BLOCK
READS
Number of message blocks received from all hosts.
Note: A message block may consist of multiple messages.
Number
Percent
Number
N, V, A
N
N, V, A
Number N, V, P
HOST BLOCK
WRITES
Number of message blocks sent to all hosts.
Note: A message block may consist of multiple messages.
Number N, V, P
HOST I/O Number of host I/Os Number N, V, P
MEM AGINGS Memory agings and collections done on old segments Number N
Kilobytes allocated to memory resources Number N, V, A, P MEM
ALLOCATE KB
MEM
ALLOCATES
Segments allocated to memory resources Number N, V, A, P
MEM FAILURES Segments allocation attempts that failed Number N
NET A USAGE Total BYNET utilization (average of the online BYNETs) Percent N
Number N, V, A, P NET READS Messages read from the BYNET and input into the resource during the sample interval
NET WRITES Messages written from the resource and output to the
BYNET during the sample interval
Number N, V, A, P
NV MEM
AGINGS
NV MEM
ALLOCATE
SEGS
NV MEM
ALLOCATE
PERCENT AMP
WORKER TASK
PERCENT
KERNEL
Backup storage disk segments flushed from nonvolatile memory (on Teradata Database V2R6.x)
Complete and partial nonvolatile memory allocations of disk segments read (written) for backup storage (on
Teradata Database V2R6.x)
Kilobytes of nonvolatile memory allocated for AMP backup storage (on Teradata Database V2R6.x)
Percent of AMP worker tasks
Time spent in UNIX PDE Kernel waiting for I/Os to complete
Number N
Number
Number
Percent
Percent
N, V, A
N
V, A
N
170 Teradata Viewpoint User Guide
Chapter 17 Node Resources
Node Resources
Metric
PERCENT
SERVICE
PERCENT
DISPATCHER
Description
CPU resources spent in UNIX PDE user service processing
Percent of CPU resources sepnt in PE Dispatcher processing
SWAP READS Segments read into resource memory from the disk during the sample interval due to swapping
SWAP WRITES Segments written to disk from resource memory during the sample interval due to swapping
Type
Percent
Percent
View
N, V, A, P
PERCENT USER CPU resources spent in non-service user code processing Percent
PARSER USAGE Percent of CPU resources spent in PE Parser processing Percent
SWAPS Total number of swap reads and swap writes
SWAP DROPS Pages and segments dropped from resource memory during the sample period due to swapping
Number N
Number N
N
V, A, P
Number N
Number
V, P
N
About the Table View
The table view can be accessed from the summary views by clicking a resource count status button in the toolbar or clicking any metric name in the preview slider. This view provides statistics and information about the resources at one time, helping you to isolate performance or system issues. This view is useful for comparing multiple vprocs.
Select and organize the displayed columns by clicking .
Click on a row to access the details view for a particular node or vproc, depending on the resource you chose from the selection menus. Following is an example of the table view for nodes.
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can also use filters to set thresholds. When thresholds are exceeded, the values are highlighted in the table view. You can sort the information in the columns. Filtering allows you to:
Teradata Viewpoint User Guide 171
Chapter 17 Node Resources
Node Resources
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filter Symbols
Use a symbol in the filter to search for words that have spelling variations or contain a specific pattern of characters. Do not use quotation marks in the filter.
\
*
?
Symbol
=
>
Description
Matches alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search. This search results are not case sensitive.
Matches zero, one, or multiple alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search.
This symbol can be used in conjunction with any other symbol.
Type this symbol at the beginning of your search to match alpha or numeric characters literally. Search results are case sensitive.
This symbol can be used in conjunction with the *, ?, and \.
Type this symbol in front of a wildcard character so the wildcard is interpreted as a regular character and not as a wildcard.
This symbol can be used in conjunction with =, ?, &, and *.
Matches any numeric value that is greater than the specified value. This symbol is only used to do mathematical comparisons.
Example of Input Highlighted Results cat?
?cat
cats, catalog
scat, Scatter cat?l
cat???
p???er
catalog
catalog
packer, parser, proper
*cat cat*l cat*
*ews*er
*%
cat, cats, catalog, scatter, wildcat
catalog
cat, cats, catalog newscaster, newsletter, newspaper what's 100%?
=CAT
=cat?
=Cat*
=Cat_
=Cat\?
CAT
cats
Cat, Cats, Catalog
Cat_
Cat?
*\?
=cat\* cat\?
what's 100%? cat*
cat?, Cat?
>60 61, 62, 63, 64, and so forth
172 Teradata Viewpoint User Guide
Chapter 17 Node Resources
Node Resources
Symbol Description
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only > and the number.
< Matches any numeric value that is less than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only < and the number.
Example of Input Highlighted Results
<60 59, 58, 57, 56, and so forth
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2
3
To clear all filter boxes all at one time, mouse over the filter .
The filter icon changes to .
Click .
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, set thresholds, and change the column display order. In the table, you can resize columns.
1
2
3
4
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click Set, type a threshold value, and click OK.
Qualifying data is highlighted in the table.
Teradata Viewpoint User Guide 173
Chapter 17 Node Resources
Node Resources
5
6
7
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
The thresholds and column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
About the Details View
The details view provides statistics and information about a particular node or vproc to help you isolate performance or system issues. This view can be accessed by clicking on a preview square in the summary view or a row in the table view.
Preview squares at the bottom of the view help you determine status for a particular vproc within the node. Mouse over a square to display an information balloon containing metrics for that vproc. Mouse over other preview squares to compare the metric values with other vprocs. When viewing a vproc, the parent node number is shown in the information balloon.
Click on a preview square to directly access the details view for another vproc. Click on the node ID to view the details view for that node.
174
Details View Metrics
The following table lists the metrics that may appear in the details view.
If the processing is skewed towards one or more AMPs (that is, the parallelism is not 100%), the metrics may display a value greater than 100%. This is due to the way the data is normalized.
Some metrics are only available in certain views.
Teradata Viewpoint User Guide
Chapter 17 Node Resources
Node Resources
N Nodes > ALL, Nodes > With AMPs, Nodes > Without AMPs
V Vprocs > ALL, Vprocs > AMP, Vprocs > PE
Metric/Name Description
STATUS Status of the node or vproc, where U means the resource is up and D means the resource is down
CLIQUE #
NODE #
Location of the clique in the rack. When there is one clique, a dash displays
Unique identifier for each node (cabinet ID and node
ID)
NODE TYPE
TYPE
SESSION LOG
COUNT
Type of node
Type of vproc
AMP COUNT Number of AMPs curently executing session requests on this node
PE COUNT Number of PEs currently active on this node
HOST ID/
CLUSTER
Host Id is the logical host identifier associated with a
PE or session. Cluster is the cluster number associated with an AMP.
Sessions currently logged on to this PE
Type
Character
Number
Number
Various
Character
Number
Number
Number
Number
SESSION RUN
COUNT
CPU USAGE
PERCENT
KERNEL
PERCENT
SERVICE
Sessions sending TSR messages to this vproc
Percent of CPU usage that is not spent being active
(not idle)
Time spent in UNIX PDE Kernel waiting for I/Os to complete
Percent of CPU resources spent in UNIX-PDE user service processing
PERCENT USER CPU resources spent in non-service user code processing
PERCENT AMP
WORKER TASK
Percent of AMP worker tasks
Number
Percent
Percent
Percent
Percent
Percent
PARSER USAGE Percent of CPU resources spent in PE Parser processing Percent
PERCENT
DISPATCHER
Percent of CPU resources spent in PE Dispatcher processing
Percent
NET A USAGE Total BYNET utilization (average of the online
DISK USAGE Percent of disk usage for this resource
CIC USAGE
BYNETs)
Percent of Channel Interface Controller usage for this resource
Percent
Percent
Percent
N
V
View
N, V
N
V
N
N
V
N
V
V
V
N
N, V
V
V
N, V
N
N, V
N, V
Teradata Viewpoint User Guide 175
Chapter 17 Node Resources
Node Resources
Metric/Name Description
DISK READS Total physical disk reads for this resource during the sample interval
DISK WRITES Total physical disk writes for this resource during the sample interval
DISK I/O
DISK OUT REQ
AVG
HOST BLOCK
READS
HOST BLOCK
WRITES
Number of disk I/Os
Average number of outstanding disk requests for this resource
Message blocks received from all hosts. A message block may consist of multiple messages.
Message blocks sent to all hosts. A message block may consist of multiple messages.
Type
Number
Number
Number
Number
Number
Number
HOST I/O Number of host I/Os
SWAP READS Segments read into node memory from the disk during the sample interval due to swapping
SWAP WRITES Segments written to disk from node memory during the sample interval due to swapping
SWAP DROPS Pages and segments dropped from node memory during the sample period due to swapping
SWAPS
MEM
ALLOCATES or
MEM ALLOCS
Total number of swap reads and swap writes
Segments allocated to memory resources
Number
Number
Number
Number
Number
Number
MEM
ALLOCATE KB
MEM
FAILURES
MEM SEGS
AGINGS
NET READS
Kilobytes allocated to memory resources
Segment allocation attempts that failed
Number
Number
Memory agings and collections done on old segments Number
Messages read from the BYNET and input into the node during the sample interval
NET WRITES Messages written from the node and output to the
BYNET during the sample interval
NV MEM
AGINGS
Backup storage disk segments flushed from nonvolatile memory (on Teradata Database V2R6.x)
Number
Number
Number
Number NV MEM
ALLOCATE
NV MEM
ALLOCATE
SEGS
PE CPU USE
Kilobytes of nonvolatile memory allocated for AMP backup storage (on Teradata Database V2R6.x)
Complete and partial nonvolatile memory allocations of disk segments read (written) for backup storage (on
Teradata Database V2R6.x)
CPU usage of the parsing engines
Number
Percent
N, V
N
N
N, V
N, V
N
N
N, V
V
View
N, V
N, V
N, V
N, V
N, V
N, V
N, V
N
N
N
N
N, V
176 Teradata Viewpoint User Guide
Metric/Name Description
AVAILABLE
AWT
Total available AMP worker tasks
AWT IN USE Total in-use AMP worker tasks
MESSAGE
COUNT
MESSAGE DQ
COUNT
Messages waiting on the vproc
Messages processed from the queue
Chapter 17 Node Resources
Node Resources
Type
Number
Number
Number
Number
View
V
V
V
V
About the Preferences View
The PREFERENCES view allows you to customize the way resource information is displayed in the portlet views.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
Slider
Metrics
Display
Select the metrics to display in the preview sliders for each view. Set the maximum threshold percent for each metric.
Display or hide nodes or cliques in the summary views that are operating within set thresholds.
Setting Metric Thresholds
Use the Slider Metrics tab in the PREFERENCES view to set metric thresholds. Use
MaxThreshold % to set the maximum range of the preview sliders in the summary views.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Slider Metrics tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a view from the list.
Select a metric from the list.
Enter the maximum threshold percent for each metric.
The maximum range of the preview sliders changes in the summary views.
Teradata Viewpoint User Guide 177
Chapter 17 Node Resources
Node Resources
7
8
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Hiding Nodes and Cliques
Use the Display tab in the PREFERENCES view to display or hide nodes or cliques in the summary views.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Display tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do one of the following:
• Select the Hide nodes or cliques that are operating within set thresholds check box to hide nodes or cliques in the summary views.
• Clear the Hide nodes or cliques that are operating within set thresholds check box to display nodes or cliques in the summary views.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
178 Teradata Viewpoint User Guide
CHAPTER 18
Productivity
Productivity
The PRODUCTIVITY portlet allows you to analyze trends in single-system performance over a 24-hour or a 48-hour period. You can also compare current performance with average performance measured across one or more weeks of historical data. Additionally, you can monitor and compare the productivity of multiple Teradata Database systems by adding a PRODUCTIVITY portlet to the view for each system to be monitored.
The summary view provides a graphic overview of selected metrics monitored over 24 or 48 hours. Samples are taken once every 15 minutes, and a data point is added to the graph for each user-selected metric.
Use the PREFERENCES view to select and organize metrics to display, set thresholds, and adjust the vertical axis range for each metric.
The PRODUCTIVITY portlet also gives you a means for comparing current with historical data by displaying past performance as an average of metric data points collected over time.
Adjust the duration over which the averages are calculated using the Past Averages tab.
About the Productivity View
The PRODUCTIVITY view provides a high-level overview of the performance trends for a single Teradata Database system during the preceding 24 hours or 48 hours. You can monitor the productivity of multiple systems by adding a PRODUCTIVITY portlet instance for each Teradata Database system to be monitored. Data trends are represented in a horizontal graph called a sparkline. Mouse over a sparkline to see an information balloon containing detailed information about the data point. There are three types of sparkline:
CANARY
RESPONSE
TIME
QUERIES
PER HOUR
Canary-response-time metrics show the time (in milliseconds) a query takes to complete. Canary response times, such as SYSTEM
HEARTBEAT are represented by a curve sparkline. Every 15 minutes, a new data point is added to the sparkline, representing the average canary response time recorded during the interval. A large dot and a number at the end of the sparkline indicate the last data point captured.
Queries-per-hour (QPH) metrics show the number of queries against the database for each hour over the 24-hour or 48-hour period for the selected metric. For example, the TOTAL QPH sparkline is a skyline sparkline, used to represent QPH metrics. A flat, solid data point represents the number of queries for each hour on the timeline.
Teradata Viewpoint User Guide 179
Chapter 18 Productivity
Productivity
SYSTEM
HEALTH
The SYSTEM HEALTH metric provides an overview of the worst state of the monitored system sampled at 15-minute intervals during the 24-hour or 48-hour period. SYSTEM HEALTH is represented by a bar sparkline.
The values on the sparkline represent the worst system state experienced during each 15-minute period.
Productivity Metrics
Select metrics to appear in the PRODUCTIVITY portlet using the Metrics tab in the
PREFERENCES view.
Metric
Canary Response Times
Metrics
System Metrics: System
Health
System Metrics: System
Heartbeat
Default
Sparkline
Curve
Bar
Curve
System Metrics: Total
QPH
Skyline
Queries Per Hour Metrics Skyline
Past
Average
Line
Yes
No
Yes
Yes
Yes
Default
No
Yes
Yes
Yes
No
Description
Select individual canary query metrics
Shows system status as Healthy, Degraded, Critical, or Down
Shows whether the Teradata Database system is responsive
Select total queries per hour metrics
Select individual queries per hour metrics
About the Preferences View
The PREFERENCES view allows you to customize the portlet to monitor key metric trends that are important to efficient operation of your Teradata Database system. You can select only one system to monitor for each portlet instance.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
System Select a Teradata Database system to monitor.
180 Teradata Viewpoint User Guide
Chapter 18 Productivity
Productivity
Metrics
Settings
Select and organize metrics to monitor in the summary view. Drag metrics from a list of all available metrics to the Preview pane where you can preview the results as you go.
Define settings for the metrics selected for display. Set thresholds to highlight metric values that are outside normal operating ranges. Set maximum vertical-axis ranges to limit the range of values displayed for selected metrics.
Adjust the number of weeks of data points used to calculate the average value for each displayed metric.
Past
Averages
Selecting a System to Monitor
Use the System tab in the PREFERENCES view to select a Teradata Database system to monitor. Only one system can be selected for each portlet instance.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the System tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a system from the list.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Selecting Metrics to Monitor
Use the Metrics tab in the PREFERENCES view to select and organize the metrics shown in the summary view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
The Preview pane uses sample data to show how metric rows are displayed in the summary view.
Teradata Viewpoint User Guide 181
Chapter 18 Productivity
Productivity
182
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do any of the following to change the way metric rows are displayed:
• Add a metric row. Drag a metric from the Select metrics for display list to the
Preview pane.
• Remove a metric row. Drag a metric from the Preview pane to the Metric Removal pane.
• Change metric row order. Drag a metric already in the Preview pane to a new location in the pane (up or down).
Note: Changes to the metrics affect only the system currently selected, provided that the metrics are available on that system.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Metric Thresholds
Use the Settings tab in the PREFERENCES view to set the THRESHOLD and VERTICAL
AXIS RANGE values for the metrics selected for display. Only metrics selected using the
Metrics tab appear in the list of available metrics.
Only a Teradata Viewpoint Administrator can enable System Health metrics and configure the degraded and critical thresholds. These selections are made in the TERADATA
SYSTEMS view of the CONFIGURATION portlet.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Settings tab.
Teradata Viewpoint User Guide
Chapter 18 Productivity
Productivity
3
4
5
6
7
[Optional] Click Clear Defaults to clear all default settings for this portlet.
[Optional] Enter the THRESHOLD setting for each available metric.
The threshold line does not appear in the view when the value entered is zero or blank.
[Optional] Enter the VERTICAL AXIS RANGE for each available metric.
The sparkline scales automatically when the value entered is zero or blank.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Past Averages
Use the Past Averages tab in the PREFERENCES view to specify the number of weeks of data points used to calculate the average values displayed in metric graphs.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Past Averages tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter the number of weeks (1 to 99 weeks).
The default is 2 weeks.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 183
Chapter 18 Productivity
Productivity
184 Teradata Viewpoint User Guide
CHAPTER 19
Query Monitor
Query Monitor
The QUERY MONITOR portlet allows you to view information about queries running in a
Teradata Database system so you can spot problem queries. You can analyze and decide whether a query is important, useful, and well written.
The summary view contains a table with one row allocated to each of the sessions running on the database. Select a row to access session and query information in the details view.
After you have identified a problem query, you can take action to correct the problem by changing the priority or workload, releasing the query, or aborting the query or session. You can take these actions for one query or session, or multiple queries or sessions at a time.
From the PREFERENCES view, you can set the criteria values used to display sessions in the My Criteria view and customize the information displayed in the views. Set criteria values to display only those sessions currently running on the selected system that exceed the specified criteria. For example, you can troubleshoot Teradata Database system problems to quickly explore details about queries such as the current state of a query or how long a query has been blocked. You can identify activity levels for individual users using the
By User view, clicking ACTIVE in the toolbar, and then sorting on the USERNAME column.
The portlet allows you to filter queries in all of the session views. You can set thresholds for any column and when the threshold is exceeded, the information is highlighted in the sessions table.
You can monitor multiple Teradata Database systems by opening additional instances of the
QUERY MONITOR portlet.
About the Query Monitor View
The QUERY MONITOR view provides a summary of sessions running on the selected
Teradata Database system. Use the selection menu to select a system and the session views.
The selections define the information and metrics that displays in the summary view. The following describes the session views:
By Session
By Account
String
All displays the sessions table for all sessions.
My Criteria displays the sessions table for sessions that exceed the set criteria values and the metrics enabled in the PREFERENCES view.
Displays the sessions table by account string.
Teradata Viewpoint User Guide 185
Chapter 19 Query Monitor
Query Monitor
By User Displays the sessions table by user.
You can use the rewind feature in the By User view to see which users were logged on at a specific time.
From the All view or My Criteria view, the Tools menu allows you to abort, change priority, change the workload, or release a query for one or multiple queries or sessions.
The bar graph provides a Top sessions by menu where you can select one of several metrics.
The graph refreshes to display sessions with the largest value compared with the total number of sessions currently running.
The toolbar provides a count of the sessions in each of the states. Click on a state to filter out all states, other than the selected state, from the view.
The sessions table provides summary information about each session in columns configured specifically for the current view. The view is refreshed every 30 seconds.
You can set the criteria values for what displays in the sessions table in the My Criteria view using the PREFERENCES view. When a session has crossed the set threshold, it displays in the sessions table. You can set criteria values only for the My Criteria view.
Filters allow you to change displayed data by only showing rows that match your search criteria. You can also use filters to set thresholds for any columns in any session view. When the threshold is exceeded, the value is highlighted in the sessions table. Click to set these thresholds.
You can sort to find the sessions you want. Click anywhere in a row in the sessions table to see session details.
186 Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
Selecting a System to Monitor
You can use selection menus above the toolbar to choose a system, type of view, and information to monitor in the portlet, starting with the highest level menu on the far left.
Different menu choices are available based on the previous menu.
Note: You are not required to make a selection from every menu each time you modify a selection.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
5
6
7
Select a system from the menu.
Click Next.
Select a type of view from the menu.
Click Next.
Select an additional type of view from the menu.
Click Next.
About the Bar Graph
The bar graph provides a Top sessions by menu where you can select one of several metrics.
A few seconds later, the graph refreshes to display sessions with the largest value compared with the total number of sessions currently running. Click on any session ID in the bar graph to see session details.
Use the maximized view to view some of the smaller sessions by clicking Other.
The Display tab in the PREFERENCES view allows you to show or hide the bar graph in the summary view.
About the Toolbar
The toolbar allows you to specify the display attributes of the view.
The query count status buttons provide near-real-time status of the number of sessions in each state category. Click on any query count status button to filter for the selected category.
For example, click DELAY to display the sessions running a query that is queued waiting to run in the selected Teradata Database system.
Teradata Viewpoint User Guide 187
Chapter 19 Query Monitor
Query Monitor
TOTAL
ACTIVE
BLOCK
Sessions currently running in the selected Teradata Database system.
Sessions running a query that is in progress.
Sessions running a query that is waiting for a locked resource such as a database table or view.
ABORT
DELAY
RESP
IDLE
PARSE
OTHER
Sessions running a query that is in the process of aborting (rolling back changes made by the query).
Sessions running a query that is queued waiting to run.
Sessions running a query that has completed and is sending (responding) spooled data back to the user.
Sessions not currently running a query.
Sessions running a query that is being parsed. It has not begun to execute.
Sessions whose status is unknown and do not fall into any of the above categories.
QTDELAYED Sessions delayed due to a queue table restriction.
SESDELAYED Utility sessions that are on the workload delay queue.
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can also use filters to set thresholds. When thresholds are exceeded, the values are highlighted in the table view. You can sort the information in the columns. Filtering allows you to:
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filter Symbols
Use a symbol in the filter to search for words that have spelling variations or contain a specific pattern of characters. Do not use quotation marks in the filter.
188 Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
\
*
?
Symbol
=
>
Description
Matches alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search. This search results are not case sensitive.
Matches zero, one, or multiple alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search.
This symbol can be used in conjunction with any other symbol.
Type this symbol at the beginning of your search to match alpha or numeric characters literally. Search results are case sensitive.
This symbol can be used in conjunction with the *, ?, and \.
Type this symbol in front of a wildcard character so the wildcard is interpreted as a regular character and not as a wildcard.
This symbol can be used in conjunction with =, ?, &, and *.
Matches any numeric value that is greater than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only > and the number.
cat?
?cat
cat?l
cat???
p???er
Example of Input Highlighted Results
cats, catalog
scat, Scatter
catalog
catalog
packer, parser, proper
*cat cat*l cat*
*ews*er
*%
cat, cats, catalog, scatter, wildcat
catalog
cat, cats, catalog newscaster, newsletter, newspaper what's 100%?
=CAT
=cat?
=Cat*
=Cat_
=Cat\?
CAT
cats
Cat, Cats, Catalog
Cat_
Cat?
*\?
=cat\* cat\?
what's 100%? cat*
cat?, Cat?
>60 61, 62, 63, 64, and so forth
< Matches any numeric value that is less than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only < and the number.
<60 59, 58, 57, 56, and so forth
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2 To clear all filter boxes all at one time, mouse over the filter .
Teradata Viewpoint User Guide 189
Chapter 19 Query Monitor
Query Monitor
3
The filter icon changes to .
Click .
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, set thresholds, and change the column display order. In the table, you can resize columns.
1
2
3
4
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click Set, type a threshold value, and click OK.
Values exceeding the threshold are highlighted and displayed in the table.
190
5
6
7
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
The thresholds and column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Symbol Reference
The following symbols appear in summary and details views:
Symbol Name Definition
ABORTING Query has been aborted, and changes are being rolled back.
ACTIVE
BLOCKED
DELAYED
Query is running.
Query is waiting for a lock held by another query.
Query is in a delay queue waiting to run.
Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
Symbol Name
IDLE
OTHER
PARSING
Definition
No query is running.
Query is in an unknown state.
Query is being parsed before running.
QTDELAYED Query is waiting for rows to be inserted into a queue table.
RESPONSE Query is returning results to the user.
SESDELAYED Query is delayed because a utility limit has been exceeded in FastLoad,
MultiLoad, FastExport, or ARC.
Summary View Metrics
Metrics appearing in the summary view can be selected using the Columns dialog box.
Metrics available for monitoring and display are listed below.
Metric
ACCOUNT
BLOCKED TIME
CPU SKEW
CPU USE
Delta CPU
Delta I/O
DURATION
HOST
IMPACT CPU
IN STATE
I/O SKEW
PARTITION
PJI
REQ CPU
REQ I/O
SESSION ID
SPOOL
START
STATE ICON
Description
Account from which a query was submitted
How long the query has been blocked
Type
Character
Number
CPU skew during the last sample Percent
Percent of the total amount of available CPU used by the query Percent
Total CPU usage time consumed, in seconds, since the last sample
I/O count since the last sample
Number
Number
How long the query has been running
Number of host systems
Total CPU seconds consumed across all AMPs that are active for this session
How long the query has been in the current state
I/O skew during the last sample
Partition in which the query is running
Number
Number
Number
Number
Percent
Character
Number Ratio of the CPU milliseconds per I/O for the query, where a larger Product Join Index number indicates system performance degradation
Number of CPU seconds needed to run the query
Number of disk I/Os performed to run the query
Unique session identifier
Amount of spool space the query requires
Time that the query started running on Teradata Database
Icon representing the current state of the query
Number
Number
Number
Number
Number
Icon
Teradata Viewpoint User Guide 191
Chapter 19 Query Monitor
Query Monitor
Metric
STATE
SYSTEM
Description
Text describing the current state of the query
Full name of the system running the query
TEMP SPACE Amount of temp space used by the query
UNNECESSARY I/O All AMP I/O divided by all AMP CPU, displayed in milliseconds, to reveal large amounts of I/O occurring over a short period of time
USERNAME
WORKLOAD
Name of the user who submitted the query
Workload in which the query is running
Type
Character
Character
Number
Number
Character
Character
User and Account String Metrics
Metrics appearing in the user or account string views can be selected using the Columns dialog box. Metrics available for monitoring and display are listed below.
Metric
ACCOUNT
USERNAME
Description
Account from which a query was submitted
Name of the user who submitted the query
Type
Character
Character
TOTAL
ACTIVE COUNT
ABORTING
BLOCKED
IDLE
PARSING
RESPONSE
DELAYED
How long the query has run, displayed as HH:MM:SS
Number of queries that are running
Queries that have been aborted and changes are being rolled back
Queries waiting for a lock held by another query.
Queries that are not running
Queries being parsed before running
Queries that are returning results to the user
Queries in a delay queue waiting to run
Number
Number
Number
Number
Number
Number
Number
Number
UNKNOWN COUNT Number of queries in an unknown state
CPU USE
Number
Percent of the total amount of available CPU used by the query Percent
I/O delta
SPOOL
Number
Number
CPU delta
IMPACT CPU
Delta REQUEST
COUNT
I/O count since the last sample
Current spool used by the current request across all AMPs, in bytes
Total CPU usage time consumed, in seconds, since the last sample
Total CPU seconds consumed across all AMPs that are active for this session
Requests initiated by the session
Number
Number
Number
192 Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
About the Details View
The details view provides statistics and information about the selected session. This view can be accessed by clicking on a session row in the summary view.
When viewing a request, you can see detailed information from the following tabs:
Overview Key statistics for a session. Any value exceeding the thresholds is highlighted.
SQL SQL for the selected query.
Explain Explain steps for the query, including step statistics and explain text.
Blocked By Details about other queries that are blocking this query.
Note: This tab is available when the selected query is blocked.
Query Band Displays the query band name and value for the selected query.
Use the Tools menu to change the priority or workload, release a query, or abort a query or session for one query or session at a time.
Use the Next and Previous buttons to move through sessions without returning to the summary view.
Details View Metrics
Query Information
Metric
STATE
TIME IN STATE
Description
Query state, such as ACTIVE, BLOCKED, TERMINATE
How long the query has been in the current state, displayed as
HH:MM:SS
TOTAL DURATION How long the query has run, displayed as HH:MM:SS
Type
Character
Number
Number
Teradata Viewpoint User Guide 193
Chapter 19 Query Monitor
Query Monitor
Metric
CPU
CPU delta
CPU SKEW
I/O SKEW
SPOOL
TEMP SPACE
WORKLOAD
PJI
CPU USE
Description
Total CPU usage time, in seconds, consumed by the query
Total CPU usage time consumed, in seconds, since the last sample
I/O
I/O delta
Number of I/O operations the query performed
I/O count since the last sample
UNNECESSARY I/O All AMP I/O divided by all AMP CPU, displayed in milliseconds, to reveal large amounts of I/O occurring over a short period of time
IMPACT CPU Total CPU seconds consumed across all AMPs that are active for this session
CPU skew during the last sample
I/O skew during the last sample
Amount of spool space the query is using
Amount of temp space the query is using
Workload where the query is actively running
Ratio of the CPU milliseconds per I/O for the query, where a larger Product Join Index number indicates system performance degradation
Type
Number
Number
Number
Number
Number
Number
Percent
Percent
Number
Number
Character
Number
Percent of the total amount of available CPU used by the query Percent
Session Information
Metric
USER
ACCOUNT
SOURCE
PARTITION
REQUESTS
Description
Name of the user who submitted the query
Account of the user who submitted the query
Source details, such as application name, IP address, and host user name
Partition in which the query is running
Number of queries submitted by the session
Type
Character
Character
Character
Character
Number
About the Details Overview Tab
The Overview tab provides detailed information about key metrics for the selected session and its queries. The metric values displayed provide a snapshot of Teradata Database system status. Metrics that exceed preset thresholds are highlighted. Under SESSION INFO, you can click on a user or account to see all sessions for that user or account string.
194 Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
About the Details SQL Tab
The SQL tab displays the SQL for the selected query. This information is read-only.
About the Details Explain Tab
The Explain tab displays an abbreviated version of the Step statistics and the Explain text that result from an Explain request in an SQL session. This information is read-only, and no actions are available from this tab. The Explain tab displays completed steps at the top of the list and future steps at the bottom. The tab periodically refreshes to display updated information. Each Explain step is uniquely identified with a number where the background of the number box indicates status.
Teradata Viewpoint User Guide 195
Chapter 19 Query Monitor
Query Monitor
• Completed steps are at the top of the list and indicated by a black number box.
• Active steps are indicated by a pulsating number box (flashes gray and white).
• Steps to run are at the bottom of the list and indicated by a white number box.
Each numbered step includes:
EST. TIME
EST. I/O
Estimated execution time for the step.
Estimated number of I/Os for the step.
ACTUAL TIME Actual CPU time consumed by the step, or blank if the step has not run.
ACTUAL I/O Actual number of I/Os for the step, or blank if the step has not run.
196
About the Details Blocked By Tab
The Blocked By tab displays details about other queries that are blocking this query. This information is read-only, and no actions are available from this tab. If this tab is unavailable, the selected query is not blocked. The Blocked By tab displays:
USERNAME Name of the user that is running the query that holds the lock.
HOST Host ID that is logged on to the session.
SESSION ID Session ID in which the blocking query was run.
LOCK TYPE Type of lock.
STATUS
LOCKED
Lock status.
Name of the locked object.
Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
About the Details Query Band Tab
The Query Band tab displays the query band name and value for the selected query. This information is read-only. For each query, the QUERY BAND tab displays:
NAME
VALUE
The name of the query band.
The value of the query band.
About the Tools Menu
The Tools menu allows you to manage queries and sessions.
Use the Tools menu to balance system resources:
Abort
Change Priority
Abort the selected query or session.
Change the priority of the selected query or session.
Teradata Viewpoint User Guide 197
Chapter 19 Query Monitor
Query Monitor
Change Workload
Release Query
Change the workload of the selected query or session.
Release the selected query from a delay queue.
Access the Tools menu from the summary view to take actions for one or more queries or sessions at a time. Access the Tools menu from the details view to take actions for a single query or session at a time.
You must log in with a user ID that has permission to abort, change priorities or workloads, or release queries. If you log out, close a portlet, or open a new portlet instance, you must log in again.
Note: If Teradata Active System Management (TASM) is enabled, Change Workload is available from the Tools menu. If TASM is disabled, Change Priority is available from the menu. If you do not see Change Workload or Change Priority in the menu, the system you are monitoring does not support these features or you do not have permission to use them. If the query you are monitoring is delayed, only Release Query is available.
Aborting a Query or a Session
This task describes how to abort a query or a session of queries that is blocking other queries or consuming too many resources.
1
2
3
4
5
6
7
From the summary view, click the row of the query you want to abort.
Click Tools > Abort.
[Optional] Log in.
Click Next.
Select one of the following:
• Abort Query to abort the selected query.
• Abort Session to abort the selected query and log off the session.
Click Next.
Click Next to confirm your selection.
Changing the Priority of a Query or Session
This task describes how to change the priority of a query or session to allow higher priority queries to run or to balance session resources.
Note: This menu item is only available when workloads are not enabled and the system being monitored supports this feature.
1
2
3
4
5
From the summary view, click the row of the query with a priority that needs to change.
Click Tools > Change Priority.
[Optional] Log in.
Click Next.
From the list of accounts that have been assigned to the user, select an account to copy the account name to the Edit new account string box.
198 Teradata Viewpoint User Guide
Chapter 19 Query Monitor
Query Monitor
6
7
8
9
10
[Optional] Edit the account string or enter a new account string.
Click Next.
Select one of the following:
• Move just this query to change the priority of the selected query.
• Move this query and all future queries associated with this session to change the priority of the selected query and all subsequent queries in the current session.
Click Next.
Click Next to confirm your selection.
Changing the Workload of a Query or Session
This task describes how to change the workload of a query or session to either allow higher priority workloads to run or to balance workload resources.
Note: This menu item is only available when workloads are enabled and the system being monitored supports this feature.
1
2
3
4
5
6
7
8
9
From the summary view, click the row of the query with the workload that needs to change.
Click Tools > Change Workload.
[Optional] Log in.
Click Next.
[Optional] Select a different workload from the list.
Click Next to confirm your selection.
Select one of the following:
• Move just this query to change the workload of the selected query.
• Move this query and all future queries associated with this session to change the workload of the selected query and all subsequent queries in the same session.
Click Next.
Click Next to confirm your selection.
Releasing a Query
This task describes how to release a query that is queued and waiting to run.
1
2
3
4
5
From the summary view, click the row of the query you want to release.
Click Tools > Release Query.
[Optional] Log in.
Click Next.
Click Next to confirm your selection.
Changing Multiple Sessions
You can change system resources for multiple sessions, users, or account strings in the following locations:
Teradata Viewpoint User Guide 199
Chapter 19 Query Monitor
Query Monitor
• All sessions table from the summary view
• My Criteria sessions table from the summary view
• User sessions table from the details view
• Account strings table from the details view
1
2
Select By Session in the selection menu and one of the following choices:
• All
• My Criteria
[Optional] Access user or account string tables from the details view.
a b
Click on a session.
Click the USER or ACCOUNT link under SESSION INFO.
3
4
5
6
7
Select an action from the Tools menu.
Check boxes appear next to the sessions.
Do one of the following:
• Select the check box in the column heading to select all sessions.
• Select the check boxes for specific sessions.
Select Submit.
[Optional] Log in.
Follow the instructions on subsequent screens.
About the Preferences View
The PREFERENCES view allows you to customize the way query and session information is displayed in the portlet views.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
Display Choose formatted or unformattet SQL to display in the SQL tab. Display or hide the bar graph in the portlet.
Criteria Set the criteria values used to display sessions in the My Criteria view. After setting the criteria value and enabling a metric, any query exceeding the criteria value appears in the sessions table in the My Criteria view.
Selecting Display Options
Use the Display tab in the PREFERENCES view to select a format for the SQL and to display or hide the bar graph.
1 From the portlet frame, click to access the PREFERENCES view.
200 Teradata Viewpoint User Guide
2
Click the Display tab.
Chapter 19 Query Monitor
Query Monitor
3
4
5
6
7
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do one of the following:
• Select the Format SQL check box to use formatted SQL.
• Clear the Format SQL check box to use unformatted SQL.
Do one of the following:
• Select the Hide bar graph check box to remove the bar graph from the portlet.
• Clear the Hide bar graph check box to display the bar graph in the portlet.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Selecting Threshold Criteria
Use the Criteria tab in the PREFERENCES view to set the criteria values used to display sessions in the My Criteria view. For each metric selected (enabled), you can set a criteria value. If an enabled metric exceeds the value, the session is displayed in the My Criteria view.
If any enabled metric is greater than the set threshold, that session displays in the My
Criteria view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Criteria tab.
Teradata Viewpoint User Guide 201
Chapter 19 Query Monitor
Query Monitor
202
3
4
5
6
7
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter specific values for each metric you want tested.
Select the metrics you want enabled.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide
CHAPTER 20
Remote Console
Remote Console
The REMOTE CONSOLE portlet allows you to run many of the Teradata Database console utilities remotely from within the Teradata Viewpoint portal.
Using this portlet, you can:
• Select or search for a system.
• Select or search for a utility.
• Enter console utility commands.
• Display responses from the commands.
Teradata field engineers, Teradata Database operators, System Administrators, and System
Programmers use Teradata Database utilities to administer, configure, monitor, and diagnose issues with Teradata Database.
About the Remote Console View
The REMOTE CONSOLE view allows you to select and run Teradata Database console utilities. You can run only one utility at a time for each portlet instance. Permission to use each console utility is granted to individual users based on their role and portlet access. If a message appears in the console denying access to a utility, you are not authorized to use that utility.
The following list describes the features in this view:
Selection Menus
Clear Console
Disconnect
Console
Input Line
Submit Command
Select a system and utility.
Clear the content from the console.
Disconnect the utility from the Teradata Database.
Display responses from the commands.
Enter commands.
Click to submit the command.
Teradata Viewpoint User Guide 203
Chapter 20 Remote Console
Remote Console
204
Running a Utility
This topic describes how to select a different system and utility, enter commands, and use the keyboard up and down arrow keys to access previous commands.
Note: Use this procedure only if you are already logged into a system and utility, and want to select a different system or utility.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
5
6
7
8
Select a system from the menu.
Click Next.
Select a utility from the menu
Click Next.
The name of the utility appears in the console.
Enter a command in the input line.
Click to submit the command.
The command results appear in the console.
[Optional] From the input line, use your keyboard up and down arrows to access previous commands.
These commands are temporarily saved and are available as long as you are running the utility. After disconnecting from the utility, these commands are cleared.
Teradata Viewpoint User Guide
Chapter 20 Remote Console
Remote Console
Note: After approximately 30 minutes of inactivity in the portlet, the Teradata Database connection times out, and you must reconnect to the utility and Teradata Database.
About the Remote Console Menus and Toolbar
The menus and toolbar allow you to specify the display attributes of the REMOTE
CONSOLE view.
Use the selection menus to:
• Select or search for a system.
• Select or search for a utility.
Use Clear Console to clear the content from the console.
Use Disconnect to disconnect from the utility and Teradata Database.
Selecting a System and Utility
You can use selection menus above the toolbar to choose a system and utility to monitor in the portlet, starting with the highest level menu on the far left. You must select a system and utility before you can submit commands and see the output in the console.
1
In the selection menu, click the currently selected system name to display a list of available systems.
2
3
4
Enter the name of the system in the Search box or select a system from the menu.
As you type, the list shows the systems that match your filter criteria.
Note: The Search box is not case sensitive. If you cannot find the correct system, press the Backspace key on your keyboard until you find the system you want in the list.
Click Next.
Enter the name of the utility in the Search box or select a utility from the menu.
As you type, the list shows the utilities that match your filter criteria.
Teradata Viewpoint User Guide 205
Chapter 20 Remote Console
Remote Console
5
Note: The Search box is not case sensitive. If you cannot find the correct utility, press the
Backspace key on your keyboard until you find the utility you want in the list.
Click Next.
Clearing the Console
This topic describes how to clear the console.
1
From the summary view, click Clear Console.
The contents of the console no longer appear.
Disconnecting from a Utility
This topic describes how to disconnect from a utility and database.
1
From the summary view, click Disconnect.
The input line no longer accepts input and the portlet no longer responds to commands.
The Teradata Database connection closes when you remove the portlet from the portal page or click Disconnect. If you close the browser without clicking Disconnect, the
Teradata Database connection times out in approximately 30 minutes.
About Console Utilities
Teradata field engineers, Teradata Database operators, System Administrators, and System
Programmers use Teradata Database utilities to administer, configure, monitor, and diagnose issues with Teradata Database.
Console Utilities
Information about available console utilities is provided in the following table. You can access only the following subset of Teradata Database utilities.
Utility
Abort Host
Check Table
Configure
Description
Cancel all outstanding transactions running on a failed host until the system restarts the host.
Check for inconsistencies between internal data structures, such as table headers, row identifiers, and secondary indexes.
Define AMPs, PEs, and hosts, and describe their interrelationships for Teradata
Database.
DBS Control
Ferret
Display and modify the DBS Control Record fields.
Define the scope of an action, such as a range of tables or selected vprocs, display the parameters and scope of the action, and perform the action. The action is to either move data to reconfigure data blocks and cylinders, or display disk space and cylinder-free-space-percent.
Gateway Control Modify default values in the fields of the Gateway Control GDO.
Lock Display Display a snapshot capture of all real-time database locks and their associated currently running sessions.
206 Teradata Viewpoint User Guide
Chapter 20 Remote Console
Remote Console
Utility
Operator
Console
Priority
Scheduler
Description
Run supervisor commands to manage the programs that perform Teradata
Database operations.
Create, modify, and monitor Teradata Database process prioritization parameters.
All processes have an assigned priority based on their Teradata Database session.
Priority Scheduler allocates CPU and I/O resources based on the priority.
Query
Configuration
Display the current Teradata Database configuration, including the node, AMP, and PE identification and status.
Query Session Monitor the state of selected Teradata Database sessions on selected logical host
IDs.
Recovery
Manager
Show Locks
Display information used to monitor progress of a Teradata Database recovery.
Display locks placed by archive and recovery, and by table rebuild operations on databases and tables.
Teradata DWM
Dump
Display information about active Teradata Dynamic Workload Manager
(Teradata DWM) rules on a Teradata Database system.
Vproc Manager Manage the vprocs including obtaining the status of specified vprocs, initializing vprocs, forcing a vproc to restart, and forcing a Teradata Database restart.
Information on how to use the majority of these utilities is located in Utilities. Information on how to use Teradata DWM Dump is in Teradata Dynamic Workload Manager User
Guide. Information on how to use Operator Console is in Graphical User Interfaces:
Database Window and Teradata MultiTool. Experienced utilities users can refer to the simplified command descriptions in Utilities Quick Reference which provides the syntax diagrams for each Teradata Database utility.
About the Preferences View
The PREFERENCES view allows you to change the console text and background colors.
From the portlet frame, click to access the PREFERENCES view.
Setting the Display Background
Use the Display tab in the PREFERENCES view to change the console text and the display background to light or dark.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Display tab.
Teradata Viewpoint User Guide 207
Chapter 20 Remote Console
Remote Console
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Change the color of the text and background by selecting one of the following options:
• Light text on dark background
• Dark text on light background
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
208 Teradata Viewpoint User Guide
CHAPTER 21
Space Usage
Space Usage
The SPACE USAGE portlet allows you to monitor Teradata Database disk space usage and reallocate permanent disk space from one database to another. Select a system and one of the following reports:
Database: By most space Displays the total, currently in use, and greatest amount in use of permanent disk space for a database.
Vproc: By space Displays the permanent disk space by processor.
The summary view allows you to monitor the database perm space, temp space, and spool space. The details view allows you to view perm space usage over time. You can reallocate permanent disk space from either of these views.
The PREFERENCES view allows you to customize the way information is displayed in the summary and details view and set thresholds for filters.
About the Space Usage View
The SPACE USAGE view provides a summary of perm, spool, and temp space for the
Teradata Databases running on the selected system. Use this information to see if you need to reallocate disk space to maximize space usage.
The following list describes the features in this view:
Selection
Menus
Toolbar
Filters
Add Space
Report
Shows the system and space usage report. You can choose a different system and report.
Shows the number of databases that exceed a set threshold of perm space, and the number of users that exceed a set percentage threshold of spool or temp space.
Click any space usage threshold button to filter for the selected category.
Set the thresholds in the PREFERENCES view.
Changes the displayed data to only show rows that match your filter criteria.
Reallocates permanent disk space from one database to another.
Shows space usage information.
Teradata Viewpoint User Guide 209
Chapter 21 Space Usage
Space Usage
About the Space Usage Menus and Toolbar
The selection menus and toolbar allow you to specify the display attributes of the SPACE
USAGE view.
210
Use the selection menus to select a system and report. You can save these selections for subsequent sessions by selecting the Use these settings as defaults check box in the
PREFERENCES view. If you have not selected this check box, you see the first system you have permission to view in the Database: By most space report.
The toolbar displays the number of databases over a set threshold. View how many users are over a set percentage threshold of spool or temp space. Click any space usage threshold button to filter for the selected category. Define the thresholds in the PREFERENCES view.
Selecting a System and Report
You can use selection menus above the toolbar to choose a system and report, starting with the highest level menu on the far left.
1
In the selection menu, click the currently selected system name to display a list of available systems.
Teradata Viewpoint User Guide
2
3
4
Select a system from the menu.
Click Next.
Select a report from the SELECT REPORT dialog box.
Chapter 21 Space Usage
Space Usage
5
Click Next.
The report appears in the summary view.
Searching for Available Disk Space
Search for available disk space to determine which databases have the least amount of disk space so you can reallocate space if necessary.
1
2
3
From the selection menus, select Database: By most space.
Click Next.
The report appears in the summary view.
Sort on a column by clicking the column heading.
Adding Space
You can reallocate permanent disk space from one database to another. Permission to reallocate disk space is granted to individual users based on their role and portlet access.
1
To reallocate space, do one of the following:
• From the summary view, click located next to the database name, and then select
Add Space from the menu that appears.
• From the details view, click Add Space.
Teradata Viewpoint User Guide 211
Chapter 21 Space Usage
Space Usage
2
3
4
5
6
7
Log in with a user ID that has permission to add space.
Click Next.
In the Add text box, enter how much space you want to reallocate.
In the from text box, select the source database from where the perm space is being taken.
Click Submit.
A confirmation message appears.
Click OK.
The space is reallocated to the database.
About Filters and Sorting
Filters allow you to change displayed data by only showing rows that match your filter criteria. You can also use filters to set thresholds. When thresholds are exceeded, the values are highlighted in the table view. You can sort the information in the columns. Filtering allows you to:
• Click in a filter box, start typing, and then press Enter. The value you enter appears in bold. After the view refreshes, only the information matching the value you entered is displayed.
• Narrow your search further by filtering on multiple columns in succession.
Sorting allows you to:
• Sort on a column by clicking the column heading. A second click sorts in descending order.
• Sort two columns consecutively. Primary sort order is indicated by a dark blue column heading, and secondary sort order is indicated by a light blue column heading.
• Sort in ascending or descending order on all pages when there are multiple pages.
The filtering, sorting, and page number settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Filter Symbols
Use a symbol in the filter to search for words that have spelling variations or contain a specific pattern of characters. Do not use quotation marks in the filter.
?
Symbol Description
Matches alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search. This search results are not case sensitive.
Example of Input Highlighted Results cat?
?cat
cats, catalog cat?l
cat???
scat, Scatter
catalog
catalog
212 Teradata Viewpoint User Guide
Chapter 21 Space Usage
Space Usage
\
*
Symbol
=
>
Description
Matches zero, one, or multiple alpha or numeric characters in the position it occupies. Type this symbol at the beginning, middle, or end of your search. This symbol can be used one or more times in the same search.
This symbol can be used in conjunction with any other symbol.
p???er
*cat cat*l cat*
*ews*er
*%
Type this symbol at the beginning of your search to match alpha or numeric characters literally. Search results are case sensitive.
This symbol can be used in conjunction with the *, ?, and \.
Type this symbol in front of a wildcard character so the wildcard is interpreted as a regular character and not as a wildcard.
This symbol can be used in conjunction with =, ?, &, and *.
Matches any numeric value that is greater than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only > and the number.
=CAT
=cat?
=Cat*
=Cat_
=Cat\?
*\?
=cat\* cat\?
>60
Example of Input Highlighted Results
packer, parser, proper
cat, cats, catalog, scatter, wildcat
catalog
cat, cats, catalog newscaster, newsletter, newspaper what's 100%?
CAT
cats
Cat, Cats, Catalog
Cat_
Cat?
what's 100%? cat*
cat?, Cat?
61, 62, 63, 64, and so forth
< Matches any numeric value that is less than the specified value. This symbol is only used to do mathematical comparisons.
Note: For columns containing percentages, do not use the percent sign (%) in the filter. Type only < and the number.
<60 59, 58, 57, 56, and so forth
Clearing Filters
You can clear the filter boxes and the highlighted content from the table.
1 To clear individual filter boxes, click .
2
3
To clear all filter boxes all at one time, mouse over the filter .
The filter icon changes to .
Click .
Teradata Viewpoint User Guide 213
Chapter 21 Space Usage
Space Usage
214
All the filter boxes clear, the content is no longer highlighted in the table, and all content displays in the table.
Configuring Columns to Display
Use the Columns dialog box to select and organize columns to be displayed, set thresholds, and change the column display order. In the table, you can resize columns.
1
2
3
4
In the table, click .
In the Columns dialog box, select the check boxes of columns to display.
Mouse over the name to see the complete name.
[Optional] Click the lock next to the column name.
The column remains stationary on the left and in the table when scrolling horizontally.
[Optional] Click Set, type a threshold value, and click OK.
Values exceeding the threshold are highlighted and displayed in the table.
5
6
7
[Optional] Click and drag the row to reorder the column.
Click Apply to save changes and close the Columns dialog box.
[Optional] In the table, drag the column border in either direction to resize the column.
The thresholds and column selection, order, and lock settings that you choose for the default or minimized display do not persist when you switch to the maximized display.
Space-Reporting Metrics
The metrics (reports) displayed in the summary view are selected using the selection menus.
Descriptions for the metrics available for monitoring and display are listed according to their report name:
• Database: By most space
• Vproc: By space
Database: By most space
This report shows the total, currently in use, and greatest amount in use of permanent disk space for the database.
Column Description Type
Teradata Viewpoint User Guide
Chapter 21 Space Usage
Space Usage
Column
Name
Max Perm
Current Perm
Current Perm %
Peak Perm
Peak Perm %
Unused Perm %
Current Perm Skew
%
Description
Database name
Total amount of permanent disk space available for the database
Percentage of the total permanent disk space currently not being used (100% minus Current Perm %)
A measure of perm space data distributed across the AMPs for the selected database
Note: A perfectly distributed database (same amount of data on each
AMP) has a skew of 0. A database which has all the data on one AMP has a skew of 100.
Type
Alpha
Number
Amount of total permanent disk space the database is currently using Number
Percentage of the total permanent disk space the database is currently using (Current Perm divided by Max Perm)
Percent
Greatest amount of permanent disk space the database has used
Highest percentage of the total permanent disk space the database has used (Peak Perm divided by Max Perm)
Number
Percent
Percent
Percent
Max Spool
Current Spool
Current Spool %
Peak Spool
Peak Spool %
Total amount of temporary spool space available for the database Number
Amount of total temporary spool space the database is currently using Number
Percentage of the total temporary spool space the database is currently using (Current Spool divided by Max Spool)
Greatest amount of temporary spool space the database has used
Highest percentage of the total temporary spool space the database has used (Peak Spool divided by Max Spool)
Total amount of temporary space available for the database
Percent
Number
Percent
Number Max Temp
Current Temp Amount of total temporary space the database is currently using
Current Temp % Percentage of the total temporary space the database is currently using (Current Spool divided by Max Spool)
Peak Temp
Peak Temp %
Greatest amount of temporary space the database has used
Highest percentage of the total temporary space the database has used (Peak Temp divided by Max Temp)
Number
Percent
Number
Percent
Parent Database Parent database name Alpha
Vproc: By space
This report shows the permanent disk space, by processor.
Column
Vproc ID
Max Perm
Description
AMP number
Total amount of permanent disk space available for the database, by processor
Type
Number
Number
Teradata Viewpoint User Guide 215
Chapter 21 Space Usage
Space Usage
Column
% in Use
Description
Current Perm Amount of total permanent disk space the database is currently using, by processor
Percentage of the total permanent disk space the database is currently using, by processor (Current Perm divided by Max Perm)
Available Perm Amount of total permanent disk space currently not being used by the database, by processor (Max Perm divided by Current Perm)
Type
Number
Percent
Number
About the Space Usage Details View
The details view displays perm space usage information for tables. Click the database name in the summary view to access the details view.
Use the sparkline to determine if the perm space usage has increased or decreased over time.
From the details view, you can:
Add Space Reallocate permanent disk space from one database to another.
Sparkline See the perm space usage over the last 3 months in the sparkline, where each data point shown on the sparkline is the amount of perm space usage recorded during a single day. Mouse over the sparkline to display detailed information about the perm space usage in an information balloon.
View the peak and max perm space usage listed to the right of the sparkline.
Filters
Report
Change displayed data by removing rows that do not match your filter criteria.
View perm space usage information for tables.
Sorting Sort on a column by clicking the column heading.
Columns Select and organize the displayed columns by clicking .
216 Teradata Viewpoint User Guide
Chapter 21 Space Usage
Space Usage
About the Preferences View
From the portlet frame, click to access the PREFERENCES view. Set the threshold values for the perm, spool, and temp space buttons in the toolbar for the Database: By most
space report. Customize the way information is displayed in the summary and details views.
Setting Filter Thresholds and Display Options
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the General tab.
3
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Teradata Viewpoint User Guide 217
Chapter 21 Space Usage
Space Usage
4
Enter specific threshold values for buttons in the summary view toolbar for the
Database: By most space report.
5
6
7
Select the Define KB, MB and GB as multiples of 1,000 instead of 1,024 check box to change the display in the summary and details views.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
218 Teradata Viewpoint User Guide
CHAPTER 22
SQL Scratchpad
SQL Scratchpad
The SQL SCRATCHPAD portlet allows you to enter queries and retrieve data from a
Teradata Database system. Select a system to run your query, enter a single or multistatement query, and then view the results.
After the Teradata Database system retrieves the data, the RESULTS section expands to display four tabs. Use the Results tab to see the results of your query. Use the SQL tab to display the SQL statements used to create the query. Use the Explain tab to see steps listed in chronological order. The steps are refreshed every 30 seconds so you can see how longer running queries are progressing. If there are delays in processing your query, you can cancel the query. If running a query takes longer than you expected, it might be blocked. Use the
Blocked By tab to see information about queries that are blocking the currently running query.
Use the OBJECT BROWSER to view a list of objects in the database. Also use the OBJECT
BROWSER to insert an object into a query to reduce the time required to build a query and help reduce errors in object names.
The SQL SCRATCHPAD portlet also allows you to save queries or export results to a file where you can sort and analyze the information. You can pin query results (pinning allows you to temporarily save the query results). Saving the query allows you to use the query in the current session or in future sessions. Use the History tab to access previously run queries from your current session.
The SQL SCRATCHPAD portlet frame displays the system name on which the query is running.
Use the PREFERENCES view to log on to a system, limit the rows returned to prevent runaway queries, or change the OBJECT BROWSER placement in the maximized view.
About the SQL Scratchpad View
The SQL SCRATCHPAD view allows you to do the following:
• Connect to or disconnect from a system
• Run or save queries
• Pin or export query results
• View and sort results
• View SQL statements
• View the Explain steps for the query
• View blocked query information
Teradata Viewpoint User Guide 219
Chapter 22 SQL Scratchpad
SQL Scratchpad
Before running a query, the SQL SCRATCHPAD portlet includes the following buttons and boxes:
Button or Box
Previous Queries
Connect/Disconnect
Description
View and load previously run queries. Access the History tab and Saved tab from Previous Queries.
Toggle between these buttons to connect to or disconnect from a
Teradata Database system.
Note: Teradata Database systems appear for those systems you are authorized to access.
YOUR QUERY
Run
Save
Object Browser
Edit and execute queries in this box.
Run a query.
Save a previously run query so you can use it in the current session or in future sessions.
View a list of objects in a Teradata Database system. Insert an object into a query to reduce the time required to build a query and help reduce errors in object names.
220 Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
After running a query, the SQL SCRATCHPAD view expands to include a RESULTS section where you can view the results of your query. Results for each statement are shown on separately numbered Query tabs. The RESULTS section includes the following buttons and tabs:
Button or Tab
Query tab
Console tab
Pin
Export
Results tab
SQL tab
Explain tab
Block By tab
Description
View the submitted statement. For multi-statement queries, each query result is shown on a separate numbered Query tab. Pin or export the query results from this tab. View information about the statement and query from the Results, SQL, Explain, and Blocked By tabs.
View information about your query as well as Teradata Database or
SQL error messages.
Temporarily save the query results during your current session.
Export your results to a comma-separated values (CSV) file.
View the results of your query (selected by default). For multistatement queries, each result is shown on a separately numbered
Query tab. The results are shown in tabular format and can be sorted in ascending or descending order.
View the SQL for your query.
View the Explain steps for the query, including step statistics and
Explain text. Information only displays while your query is running.
View details about other queries that are blocking the query.
Information appears only while your query is running. The contents of this tab varies, depending on your permission level.
Permission to access the Explain and Blocked By tabs is granted to individual users based on their role. Unavailable or dimmed tabs indicate that either no information is available, or you are not authorized to view the information.
Connecting to a System
This topic describes how to connect to a Teradata Database system.
1
2
3
4
Click Connect.
The CONNECT TO SYSTEM dialog box appears.
Select a system from the list.
Teradata Database systems appear for those systems you are authorized to access.
Enter the following information in the appropriate fields: a
User Name b
Password c
[Optional] Account String
[Optional] Select a character set from the list.
UTF8 is the default character set.
Teradata Viewpoint User Guide 221
Chapter 22 SQL Scratchpad
SQL Scratchpad
5
Click Connect.
Disconnecting from a System
This topic describes how to disconnect from a Teradata Database system.
Use this procedure only if you are currently connected to a system.
1
From the SQL SCRATCHPAD view, click Disconnect.
The system name disappears from the portlet frame.
Saving a Query
This topic describes how to save a query. Typically, you save queries to run them in future sessions. Queries can also be saved and run in the current session.
Use this procedure only if there is a query in the YOUR QUERY box.
1
From the SQL SCRATCHPAD view, click Save.
2
3
4
In the Name box, enter a name.
Click Save.
[Optional] To view your saved query: a b
Click Previous Queries.
Click the Saved tab.
Pinning Query Results
This topic describes how to pin query results so the results are not lost when you run a new query. Pinning query results temporarily saves them for the current session.
Use this procedure only if you have run a query.
1
From the SQL SCRATCHPAD view, click the Query tab (located under RESULTS) that contains the query you want to pin.
2
Click Pin.
222
3
The tab name changes to Pinned, and the query results are temporarily saved until you unpin it or disconnect from the Teradata Database system.
[Optional] To unpin your query, click Unpin.
The tab name changes back to Query. The query is unpinned and disappears from the
Query tab after you run a new query.
Exporting the Results to a File
This topic describes how to export your query results to a comma-separated values (CSV) file where you can sort and analyze the information. In a CSV file, the comma character (,) usually separates each field of text.
Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
You can only export the rows that are visible in the Results tab, up to 500 rows.
Use this procedure only if you have run a query.
1
2
From the SQL SCRATCHPAD view, click the Query tab located under RESULTS that contains the results you want to export.
Click Export.
3
4
A dialog box appears enabling you to save or open the file.
[Optional] To save, do the following: a
Click Save.
b
Choose a directory.
The results are saved as a CSV file.
[Optional] Click Open.
The results appear in the application you have associated with CSV files where you can sort and analyze the information. You can also open the file using an application such as
Microsoft Excel.
About the Results Tab
The Results tab displays the results of your query in tabular format. Sort on a column by clicking the column heading.
View results for single-statement queries in the Query 1 tab. View results for multistatement queries in two or more Query tabs. The tabs are numbered sequentially in the order you submitted them. For example, if three statements are submitted, the results from your first statement appear in the Query 1 tab, the results from your second statement
Teradata Viewpoint User Guide 223
Chapter 22 SQL Scratchpad
SQL Scratchpad appear in the Query 2 tab, and the results from your third statement appear in the Query 3 tab.
To view more rows in your results, use the slider located at the bottom of the portlet.
Information in the Results tab is read-only.
About the SQL Tab
The SQL tab displays the SQL statements used to create the query.This information is readonly.
224
View the SQL for single-statement queries in the Query 1 tab. View the SQL for multistatement queries in two or more Query tabs. The tabs are numbered sequentially in the order you submitted them. For example, if three statements are submitted, the SQL for the first statement appears in the Query 1 tab, the SQL for the second statement appears in the
Query 2 tab, and the SQL for the third statement appears in the Query 3 tab.
About the Explain Tab
The Explain tab displays step statistics and the Explain text for the query. No information displays in this tab after a query has stopped running. This information is read-only and no actions are available from this tab. The Explain tab lists steps in order, with completed steps at the top of the list and future steps at the bottom.
Information in this tab is refreshed every 30 seconds so you can see how longer-running queries are progressing. If there are delays in processing your query, you can cancel the query. When longer-running queries have multiple statements, each statement has its own
Explain tab, located within each Query tab.
Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
Each Explain step is uniquely identified with a number where the background of the number box indicates status.
• Completed steps are at the top of the list and indicated by a black number box.
• Active steps are indicated by a pulsating number box (flashes gray and white).
• Steps to run are at the bottom of the list and indicated by a white number box.
Each numbered step includes:
EST. TIME
EST. I/O
Estimated execution time for the step.
Estimated number of I/Os for the step.
ACTUAL TIME Actual CPU time consumed by the step, or blank if the step has not run.
ACTUAL I/O Actual number of I/Os for the step, or blank if the step has not run.
About the Blocked By Tab
The Blocked By tab displays details about other queries that are blocking this query. This information is read-only and no actions are available from this tab. If this tab is unavailable, the selected query is not blocked.
The BLOCKED BY tab displays:
USERNAME Name of the user that is running the query that holds the lock.
HOST Host ID that is logged on to the session.
SESSION ID Session ID in which the blocking query was run.
LOCK TYPE Type of lock.
STATUS Lock status.
LOCKED Name of the locked object.
Teradata Viewpoint User Guide 225
Chapter 22 SQL Scratchpad
SQL Scratchpad
About Running a Query
This topic describes usage of DML and DDL statements and information about running queries.
Use any SQL, Data Manipulation Language (DML), or Data Definition Language (DDL) statement. DML refers to
INSERT
,
UPDATE
, or
DELETE
statements. DDL refers to
CREATE
,
MODIFY
,
DROP
,
GRANT
,
REVOKE
,
GIVE
,
ALERT
,
SHOW
, and
HELP
statements.
Submit single or multi-statement queries. A semicolon is not required when entering one statement. However, a semicolon between the statements is required for two or more statements. Each statement in the query is submitted separately to the database. Results appear in the Query 1 tab for single-statement queries. Results appear in two or more tabs for multi-statement queries. For example, if three statements are submitted, the results appear in the Query 1, Query 2, and Query 3 tabs.
Running a Query
This topic describes how to enter and send queries to a Teradata Database.
The portlet frame includes the system name on which the query is running.
1
2
From the SQL SCRATCHPAD view, enter a query into the YOUR QUERY box.
Click Run.
An icon appears showing the query is being processed.
Viewing Query Results
This topic describes how to view results and information about a query you ran. The
PREFERENCES view allows you to change the number of rows returned in the results.
1
From the RESULTS section, view the results of your query in the Query tab.
226
2
3
[Optional] Sort on a column by clicking the column heading.
[Optional] Click the Console tab to see the following information about your query:
Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
• Date and time the query was run
• Amount of time it took for the query to run
• SQL statement that was run
• Status, including whether the query ran successfully
• Number of SQL statements that were run
• Teradata Database or SQL error messages
About the Object Browser
The OBJECT BROWSER allows you to view a list of objects in a Teradata Database system and insert an object into a query. Use the OBJECT BROWSER to reduce the time required to build a query and help reduce errors in object names. Use filtering to search for objects in the OBJECT BROWSER.
The OBJECT BROWSER employs a directory tree that is organized in a hierarchical structure, displaying a list of databases and users on the connected system.
Click or the database or user name to expand the tree. Five object types appear for each database or user. The object types are:
• Tables
• Views
• Macros
• Functions
• Procedures
After clicking or the object type name, the tree expands and the objects load. The number of existing objects appears after the name of the object type. If no objects exist, 0 items displays. When you click to highlight the object and then click Insert, the name of the object automatically appears in the YOUR QUERY box.
The objects shown in the OBJECT BROWSER can be refreshed by clicking the Teradata
Database name at the top of the directory tree to collapse the tree and then clicking the
Teradata Database name again to expand the tree.
Teradata Viewpoint User Guide 227
Chapter 22 SQL Scratchpad
SQL Scratchpad
Use the PREFERENCES view to position the OBJECT BROWSER to the left or right of the
YOUR QUERY box when using the maximized view.
In normal view, the OBJECT BROWSER is located below the YOUR QUERY box. You cannot change the location of the OBJECT BROWSER in the normal view.
About Filtering Objects
Use filtering to search for objects in the OBJECT BROWSER.
Filter boxes are located at each level in the directory tree. Select a filter box above (parent) or below (child) the current level in the directory tree. At the parent level, filtering finds databases or users matching your search criteria. For example, if you enter dbc
, databases and users containing DBC appear, as shown below.
Object types are located at the child level in the directory tree. The object types are tables, views, macros, functions, and procedures. Expand each object type and use the filter box to find objects matching your search criteria. For example, if you enter clear
in the filter box located under Macros, macros containing Clear appear, as shown below.
228
After entering your search criteria, the OBJECT BROWSER automatically displays the matching results.
Note: The search criteria you put in the filter box is not case sensitive.
Perform a new search by using the Backspace key on your keyboard to delete the contents of the filter box and enter new search criteria.
The state of the OBJECT BROWSER (which level you last filtered) is saved until you disconnect from the Teradata system. Disconnecting resets the state of the OBJECT
BROWSER.
Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
The displayed results are limited to 500 objects.
Inserting an Object into a Query
This topic describes how to insert an object into a query using the OBJECT BROWSER.
Filtering can be used to search for objects in the directory tree.
1
2
3
4
5
6
7
From the SQL SCRATCHPAD view, click in the YOUR QUERY box where you want to insert the object.
Click Object Browser.
The OBJECT BROWSER opens, displaying the name of the connected Teradata
Database system.
Click or the Teradata Database system name to expand the directory tree.
A list of databases and users on the connected system appears, along with the number of databases and users.
[Optional] At the parent level, use the filter box to search for databases or users.
Click or the database or user name to expand the directory tree.
The object types appear, along with the number of object types.
Click or the object type name (Tables, Views, Macros, Functions, or Procedures) to expand the directory tree.
For example, click or Macros to expand the directory tree to view the available macros.
[Optional] At the child level, use the filter box to search for objects, as shown below.
8
9
Click to highlight the object name, and then click Insert.
The object name automatically appears in the YOUR QUERY box.
[Optional] To refresh the objects shown in the OBJECT BROWSER, click the Teradata
Database system name at the top of the directory tree to collapse the tree, then click it again to expand the directory tree.
Teradata Viewpoint User Guide 229
Chapter 22 SQL Scratchpad
SQL Scratchpad
10
Click Close to close the OBJECT BROWSER.
About the History Tab
Use the History tab to view the following for previously run queries from your current session:
• Date and time the query was run
• Amount of time it took for the query to run
• Number of records returned
• Complete SQL statement that was run
Use Load to automatically load the query in the YOUR QUERY box and run it again.
230
Viewing Previously Run Queries
This topic describes how to view previously run queries from your current session.
Use this procedure only after you have run a query in your current session.
1
From the SQL SCRATCHPAD view, click Previous Queries.
The History tab appears, by default.
The following information is displayed for each query:
• Date and time the query was run
• Amount of time it took for the query to run
Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
2
• Number of records returned
• Complete SQL statement that was run
Click Close.
Loading a Previously Run Query
This topic describes how to load a previously run query from your current session to run it again or edit it before running it again.
Use this procedure only after you have run a query in your current session.
1
2
3
4
From the SQL SCRATCHPAD view, click Previous Queries.
The History tab appears, by default.
View the list to locate the query you want to run.
Click Load.
The query loads in the YOUR QUERY box, and the History tab closes.
[Optional] Edit the query before running it.
About the Saved Tab
Use the Saved tab to view and load previously saved queries, and delete saved queries.
Typically, you save queries to run them in future sessions. Queries can also be saved and run in the current session.
Use Load to automatically load the query in the YOUR QUERY box, then run the query again or edit the query before running it.
Use Delete to delete a saved query.
Teradata Viewpoint User Guide 231
Chapter 22 SQL Scratchpad
SQL Scratchpad
Viewing Saved Queries
This topic describes how to view saved queries. Typically, you save queries to run them in future sessions. Queries can also be saved and run in the current session.
Use this procedure only after you have saved a query.
1
2
3
From the SQL SCRATCHPAD view, click Previous Queries.
The History tab appears, by default.
Click the Saved tab.
The query name and the SQL statement appears.
Click Close.
Loading a Saved Query
This topic describes how to load a saved query to run it again or edit it before running it again.
Use this procedure only if you have previously saved a query.
1
2
3
4
5
From the SQL SCRATCHPAD view, click Previous Queries.
The History tab appears, by default.
Click the Saved tab.
View the list to locate the query you want to run.
Click Load.
The query loads in the YOUR QUERY box, and the Saved tab closes.
[Optional] Edit the query before running it.
Deleting a Saved Query
This topic describes how delete a saved query.
Use this procedure only if you have previously saved a query.
1
2
3
4
From the SQL SCRATCHPAD view, click Previous Queries.
The History tab appears, by default.
Click the Saved tab.
View the list to locate the query you want to delete
Click Delete.
The button is located next to the Query number in parentheses.
5
A confirmation message appears.
Click OK.
232 Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
About the Console
In your query results, the console tab allows you to view detailed query information including:
• Date and time the query was run
• Amount of time it took the query to run
• SQL statement that was run
• Status including whether the query was run successfully
• Number of SQL statements that were run
• Teradata Database error messages
• SQL error messages
About the Preferences View
The PREFERENCES view allows you change default connection settings, limit rows returned in the results, and place the OBJECT BROWSER.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
Connection Change the default connection settings for the Teradata Database system, account string, and character set. Only one Teradata Database system can be selected for each portlet instance.
Note: Teradata Database systems appear for those systems you are authorized to access.
Settings
Object
Browser
Set a limit on the number of rows returned in the results to prevent runaway queries.
Change the OBJECT BROWSER placement to display to the left or right of the YOUR QUERY box (only in maximized view). You cannot change the OBJECT BROWSER location in the normal view.
Changing Default Connection Settings
Use the Connection tab in the PREFERENCES view to change default connection settings.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Connection tab.
3
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Teradata Viewpoint User Guide 233
Chapter 22 SQL Scratchpad
SQL Scratchpad
4
5
6
7
8
Select a system from the list.
[Optional] Enter the Account String.
[Optional] Select a character set from the list.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Limiting Rows Returned
Use the Settings tab in the PREFERENCES view to limit the rows returned to prevent runaway queries. Specify 1 to 500 rows. The number of rows returned in the results cannot exceed the specified amount. The default is 500 rows. Increasing the number of rows might reduce the portlet response time and take your queries longer to run.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Settings tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
In the Limit Rows box, enter the maximum number of rows to return in the results.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Placing the Object Browser
Use the Object Browser tab in the PREFERENCES view to change the OBJECT BROWSER placement in the maximized view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Object Browser tab.
234 Teradata Viewpoint User Guide
Chapter 22 SQL Scratchpad
SQL Scratchpad
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do one of the following:
• Select On the right to position the OBJECT BROWSER to the right of the YOUR
QUERY box in the SQL SCRATCHPAD view.
• Select On the left to position the OBJECT BROWSER to the left of the YOUR
QUERY box in the SQL SCRATCHPAD view.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 235
Chapter 22 SQL Scratchpad
SQL Scratchpad
236 Teradata Viewpoint User Guide
CHAPTER 23
System Health
System Health
The SYSTEM HEALTH portlet monitors and displays the status of the selected Teradata
Database systems using a predefined set of metrics and thresholds. This portlet reports status as one of five states: healthy, warning, critical, down, or unknown, and allows you to investigate metrics exceeding healthy thresholds. This portlet has two main views:
SYSTEM
HEALTH
SYSTEM
HEALTH
DETAILS
Provides status at a glance using color-coded text and icons to indicate overall health of monitored systems. Typically, metrics and thresholds are carefully selected to highlight when there is an unusual load on the system that has the potential to impact overall performance.
Provides details and information about the metrics used to evaluate overall system health. For less-than-healthy systems, metrics exceeding thresholds are highlighted in the exception color to indicate their status.
Customize these views from the PREFERENCES view. From the PREFERENCES tabs, you can select systems to monitor and choose an icon style to represent monitored systems.
Your Teradata Viewpoint Administrator selects the metrics that appear in the SYSTEM
HEALTH DETAILS view and sets warning and critical thresholds.
Note: Only a Teradata Viewpoint Administrator can enable System Health metrics and configure the warning and critical thresholds.
About the System Health View
The SYSTEM HEALTH summary view provides a summary of overall system status, using colored text and icons. The summary shows status for one or more Teradata Database systems.
The SYSTEM HEALTH summary view icons describes Teradata Database system status as either healthy, warning, critical, down, or unknown.
Teradata Viewpoint User Guide 237
Chapter 23 System Health
System Health
Icon Text Color
Blue
Orange
Red
Status
Healthy
Definition
All metrics are within healthy ranges.
Warning At least one metric exceeded the warning threshold.
Critical At least one metric exceeded the critical threshold.
Black Down The selected system is down.
Black (with Question
Mark)
Unknown Status of the selected system is unknown.
Customize the icons shown using the PREFERENCES view, Icons tab. Click to access the PREFERENCES view, and then select the Icons tab to access these icons.
From the SYSTEM HEALTH summary view, click anywhere on a status icon or text to access the selected SYSTEM HEALTH DETAILS view.
About the System Health Details View
The SYSTEM HEALTH DETAILS view provides detailed statistics and information about each metric used to evaluate the overall health of a Teradata Database system.
This view presents detailed metric information in several different ways:
METRIC
VALUE VS
THRESHOLD
Lists the color-coded names of the monitored metrics. Metric names are color-coded to indicate health status.
Shows the current value in the context of healthy, warning, and critical ranges. Warning and critical thresholds are indicated by gaps in the bar; current value is represented by the end of the colored bar.
238 Teradata Viewpoint User Guide
Chapter 23 System Health
System Health
The at the end of some bar graphs indicates an unbounded metric.
Unbounded metrics are defined by numerical values with no upper limit.
The appears (colored red) if the unbounded metric's current value exceeds 1.2 times the critical threshold.
LAST nn MIN Displays a sparkline (trend line) showing the values of the metric over a user-selected duration of 15, 30, or 60 minutes. For warning or critical metrics, the sparkline shows the trend in the metric value over time, suggesting whether the system is expected to degrade or improve in the future.
VALUE
Select a 15-minute, 30-minute, or 60-minute interval using the
PREFERENCES view.
Shows the value of the metric at the last sampling of the Teradata
Database system. This value is also color-coded to indicate metric health.
System Health Details View Metrics
Metrics appearing in your SYSTEM HEALTH details view are selected for you by your
Teradata Viewpoint Administrator. Metrics available for selection and display are listed below.
Metric Description
CPU UTILIZATION Average node CPU use
(CPU) USER
(CPU) SYSTEM
Average percentage of CPU time spent in user mode
Type
Percent
Percent
Average percentage of CPU time spent in system (kernel) mode Percent
(CPU) WAIT IO
NODE CPU SKEW
NODE IO SKEW
AMP CPU SKEW
Average percentage of CPU time spent waiting for I/O
Comparison of CPU use on the busiest node to the average node Percent
Comparison of disk use on the busiest node to the average node Percent
Comparison of CPU use on the busiest AMP to the average
AMP
Percent
Percent
AMP IO SKEW Comparison of disk use on the busiest AMP to the average AMP Percent
AMP WORKER TASKS Average number of AMP worker tasks in use on each AMP Number
Teradata Viewpoint User Guide 239
Chapter 23 System Health
System Health
Metric Description
TOTAL DISK SPACE Percentage of total disk space currently in use
MAX DISK SPACE BY
AMP
Available disk space currently in use
COMPONENT
DOWN
MEMORY USED
Type
Percent
Percent
Number of components, such as BYNETs or AMPs that are down
Number
Average amount of memory currently in use on each node (KB) Number
MAX SPOOL BY AMP Available spool space in use
MEMORY FAILURES Memory failures across all nodes
DBC DISK SPACE
ACTIVE SESSIONS
Available DBC disk space in use
Number of sessions with active queries
Percent
Number
Percent
Number
SYSTEM HEARTBEAT Response time of the most recent system heartbeat query (ms) Number
Additional Canaries Additional canary queries that are defined for the system and used as part of the monitoring of system health
Number
About the Preferences View
The PREFERENCES view allows you to customize the portlet to display information that is most useful to you.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
Systems
Icons
Trend
Interval
Select Teradata Database systems to monitor in the SYSTEM HEALTH and SYSTEM HEALTH DETAILS views.
Select an icon style to use in the SYSTEM HEALTH view.
Select the interval for the SYSTEM HEALTH trend line. Choose from among 15, 30, or 60 minutes of historical data.
Selecting Systems to Monitor
Use the Systems tab in the PREFERENCES view to select Teradata Database systems to monitor in the summary and details views.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Systems tab.
240 Teradata Viewpoint User Guide
Chapter 23 System Health
System Health
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select the check boxes of systems to display.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Selecting the System Health Icon Style
Use the Icons tab in the PREFERENCES view to select the icon style to display in the
SYSTEM HEALTH view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Icons tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select the icon style to use in the SYSTEM HEALTH view.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 241
Chapter 23 System Health
System Health
Setting the System Health Trend Interval
Use the Trend Interval tab in the PREFERENCES view to set the length of time used to plot the sparklines in the SYSTEM HEALTH DETAILS view. This interval applies to all metrics selected for this view.
The Example pane provides a sample of how the SYSTEM HEALTH view might look after the change.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Trend Interval tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
From the Interval list, select an interval.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
242 Teradata Viewpoint User Guide
CHAPTER 24
Today's Statistics
Today's Statistics
The TODAYS STATISTICS portlet allows you to monitor current resource-use statistics and compare them to statistics collected during the same period one or more weeks in the past. Additionally, you can monitor and compare the performance of multiple Teradata
Database systems by adding a TODAYS STATISTICS portlet to the portal page for each monitored system.
Teradata Viewpoint Administrators and managers typically use the TODAYS STATISTICS portlet to determine if users are getting value from their Teradata Database system. Data is presented in a table, allowing you to compare metric values collected recently (today and as far in the past as yesterday) to values collected during the same time period up to 999 weeks in the past. This view is refreshed once every 2 minutes with displayed values updated for each user-selected metric.
About the Today's Statistics View
The TODAYS STATISTICS view provides a statistical analysis of system-resource use over a user-defined time period. A table lists the monitored metrics and compares current statistics to statistics from the same time period 1 or more weeks in the past. Metrics are grouped into categories so that metric data collected at the same frequency is displayed together in the view. The view is refreshed every 2 minutes.
Use the PREFERENCES view to select the system and metrics category to monitor, set metrics thresholds, and set the sampling interval.
Teradata Viewpoint User Guide 243
Chapter 24 Today's Statistics
Today's Statistics
Note: The heading for the second column depends on the selections made in the
PREFERENCES view and how frequently data for each metric is collected. For example, the heading LAST 2 HOURS appears when the sampling interval is 2 hours and data for the previous 2 hours is available. The same heading could appear as SINCE AUG 20, 2:10 AM if the sampling interval is set to 2 hours and the data was last collected more than 2 hours ago.
Table columns provide the following information:
STATISTIC
SINCE DATE, X AM/
PM
The name of the monitored metric. This column can be sorted.
The value of the metric at the date and time the data was last collected.
Note: This column heading is used for metrics in the query category.
LAST X HOUR(S)
SAME PERIOD X
WEEK(S) AGO
SINCE X AM/PM
TODAY/YESTERDAY
SAME PERIOD X
WEEK(S) AGO
The value of the metric from a user-specified number of hours ago, up to 999 hours in the past, until the current time.
The value of the metric over the same time period as LAST X
HOUR(S), up to 999 weeks in the past.
The value of the metric calculated from a user-specified hour of the day, either today or as far in the past as yesterday, until the current time.
The value of the metric over the same time period as SINCE X AM/
PM TODAY/YESTERDAY, up to 999 weeks in the past.
Your Teradata Viewpoint Administrator must enable the appropriate collectors to display statistics in the TODAYS STATISTICS view. The Teradata Viewpoint Administrator also specifies the data-collection rate for each collector.
Today's Statistics View Metrics
Use the Metrics tab in the PREFERENCES view to select metrics for display in the
TODAYS STATISTICS view. Detailed information about available metrics is provided in the table.
Note: The Teradata Viewpoint Administrator must enable the appropriate collectors to calculate and display statistical data in the TODAYS STATISTICS view. When the Canary
Queries Collector is the source for a metric, the data displayed is always the heartbeat query for the selected system.
Category
System
Name
Active Sessions
AMP CPU Skew
AMP I/O Skew
AWT
CPU
Memory Used
System CPU
Collectors
System Statistics
System Statistics
System Statistics
System Statistics
System Statistics
System Statistics
System Statistics
Units
Sessions
Percent
Percent
AWTs
Percent
Bytes
Percent
Calculation
Average
Average
Average
Average
Average
Average
Average
244 Teradata Viewpoint User Guide
Category
Query
Performance
Name
Total Disk Space
User CPU
Wait I/O CPU
Concurrency
First Response Time
Avg
First Response Time
Max
Collectors
System Statistics
System Statistics
System Statistics
Query Count
Query Count
Query Count
First Response Time
Min
First Response Time
StdDev
Query Count
Query Count
Query Count
Spool Usage Avg
Spool Usage Max
Spool Usage Min
Query Count
Query Count
Query Count
Query Count
Spool Usage StdDev Query Count
Response Time Canary Queries
Response Returned Canary Queries
Chapter 24 Today's Statistics
Today's Statistics
Units
Percent
Percent
Calculation
Average
Average
Percent
Queries
Average
Average
Milliseconds Average
Milliseconds Maximum
Milliseconds Minimum
Milliseconds Standard
Deviation
Queries
Bytes
Sum
Average
Bytes
Bytes
Maximum
Minimum
Bytes Standard
Deviation
Milliseconds Average
Rows Average
About the Preferences View
The PREFERENCES view allows you to customize the portlet to monitor key metric trends to determine if you are getting value from your Teradata Database system. Only one system can be selected for each portlet instance.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
System
Metrics
Sampling
Interval
Select a Teradata Database system to monitor.
Select appropriate metrics, by category, for display in the view, and set values for highlighting metrics beyond a specified threshold. Metric values that exceed the threshold are displayed in the exception color.
Specify the time periods from which statistics are displayed. Set the number of hours (up to 999) prior to the current time, and define a comparison period up to 999 weeks in the past.
Selecting a System to Monitor
Use the System tab in the PREFERENCES view to select a Teradata Database system to monitor. Only one system can be selected for each portlet instance.
Teradata Viewpoint User Guide 245
Chapter 24 Today's Statistics
Today's Statistics
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the System tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a system from the list.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Metric Thresholds
Use the Metrics tab in the PREFERENCES view to select a metrics category to monitor and to set thresholds to trigger the highlighting of values that exceed the thresholds.
To display statistical data in the TODAYS STATISTICS view, your Teradata Viewpoint
Administrator must first enable the appropriate Teradata Viewpoint collectors, including
Query count, System statistics, and Canary queries. Factors external to Teradata Viewpoint can also affect the collection and display of statistical data:
• Query Logging. Your Teradata System Administrator must enable query logging on the
Teradata Database system.
• Data Collection. Query data must have been collected during all time periods selected on the Sampling Interval tab. Teradata Viewpoint collectors and query logging must have been enabled during all selected time periods in order for TODAYS STATISTICS data to display correctly.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
246 Teradata Viewpoint User Guide
Chapter 24 Today's Statistics
Today's Statistics
3
4
5
6
7
8
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a metrics category.
When the Canary Queries Collector is the source for a metric, the data displayed is always the heartbeat query for the selected system.
In the Metric column, select check boxes for the metrics you want to monitor in the view.
[Optional] For each metric selected, enter a Threshold value.
Values exceeding the threshold are highlighted in the view using the exception color.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting the Sampling Interval
Use the Sampling Interval tab in the PREFERENCES view to set the length of time used to calculate the statistics shown in the TODAYS STATISTICS view. The Sampling Interval applies to all metrics selected for display.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Sampling Interval tab.
Teradata Viewpoint User Guide 247
Chapter 24 Today's Statistics
Today's Statistics
3
4
5
6
7
8
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter the number of hours (up to 999) in the Statistics will be sampled during the last
X hour(s) field.
The value you enter determines the sampling interval for columns 2 and 3 of the
TODAYS STATISTICS view.
Enter the since sampling interval as follows: a
Select the time of day that begins the interval.
b
Select Today or Yesterday from the list.
This value pair defines a start time up to 48 hours in the past for calculating column 4 of the TODAYS STATISTICS view.
Enter a value for the comparison period, up to 999 weeks in the past.
The value you enter defines the number of weeks in the past for calculating column 5 of the TODAYS STATISTICS view.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
248 Teradata Viewpoint User Guide
CHAPTER 25
Viewpoint Monitoring
Viewpoint Monitoring
The VIEWPOINT MONITORING portlet allows you to analyze resource usage trends on one or more Teradata Viewpoint servers or other managed servers. Trends are graphed according to metrics such as CPU, memory, and throughput within a specified time range.
The VIEWPOINT MONITORING view displays a graph with time on the horizontal axis, metric values on the vertical axis, and a different color for each metric sparkline. Sparklines show the average metric values as a line and have enhanced interactive features such as performance envelopes and information balloons that show the actual, minimum, and maximum metric values. Time-range buttons allow you to monitor current usage within the last hour or view usage trends over the last day, week, month, 3 months, or 6 months.
The PREFERENCES view allows you to select and organize metrics to display, set thresholds, and adjust the vertical axis range for each metric.
About the Viewpoint Monitoring View
The VIEWPOINT MONITORING view provides a graph that shows Teradata Viewpoint server resource usage. One or more Teradata Viewpoint servers can be monitored in the time range using the same or different metrics. Up to 10 metrics can be selected with different thresholds and vertical axis ranges. Each sparkline is assigned a color for every metric plotted in the graph.
Teradata Viewpoint User Guide 249
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
250
The following list describes the features in this view:
Toolbar Contains the time-range buttons. Select a time-range button to change the graph.
Graph Plots the time range on the horizontal axis and the metric values on the vertical axis. The sparkline is a colored line that represents the average metric values.
Click a sparkline to see the highlighted sparkline and performance envelope. The performance envelope appears in a lighter shade of the sparkline color and represents the upper and lower metric values.
Metrics Lists the metrics that are defined in the PREFERENCES view. Each metric has a color and a checkbox. The metric name appears along with the name of the system being monitored if there is more than one system enabled. Select a metric name to see the sparkline highlighted and surrounded by the performance envelope in the graph.
About Metric Thresholds
Set thresholds to highlight metric values that are outside normal operating ranges. Set maximum vertical-axis ranges to limit the range of values displayed for selected metrics.
After a metric threshold is set in the PREFERENCES view, the threshold line is displayed across the graph with the threshold value to the right of the graph when you select a metric sparkline. As you mouse over the selected sparkline, information balloons display the data point value and the minimum and maximum performance envelope values. The sparkline and information balloons change to red when the threshold is exceeded during the time range. Threshold settings are optional and can be set any time after the metric has been configured.
Teradata Viewpoint User Guide
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
Setting the Time Range
This task describes how to set the time range that is used to plot the graph.
1
In the toolbar, click a time-range button.
The portlet refreshes, and the graph is redrawn.
Removing Metrics from the Graph
This task describes how to disable metric sparklines.
1
Clear the color-coded checkbox on the metric line.
The metric sparkline disappears from the graph, but not from the list below the graph.
About the Toolbar
The toolbar allows you to choose the time range to display in the graph. The graph displays oldest data on the left and the most recent data on the right. For each metric, data is collected every 15 seconds and averaged according to the time range chosen.
Teradata Viewpoint User Guide 251
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
Button
1 hour
1 day
1 week
1 mo
3 mo
6 mo
Description
Displays the metric values for the last hour, plotted by minute.
Displays the metric values for the last 24 hours, plotted by 15-minute periods.
Displays the metric values for the last week, plotted by hour.
Displays the metric values for the last month, plotted by 4-hour periods.
Displays the metric values for the last 3 months, plotted by 12-hour periods.
Displays the metric values for the last 6 months, plotted by day.
Clicking a different time-range button causes the portlet to immediately recalculate and update the graph based on the data points collected for the metrics.
Viewpoint Monitoring Metrics
The following metrics are available to analyze resource usage.
CPU Metrics
Metric
CPU IDLE
CPU INVOLUNTARY
WAIT
CPU I/O WAIT
CPU SYSTEM
CPU USER
CPU USAGE
Description
Percent of total CPU time spent idle.
Percent of total CPU time spent waiting involuntarily.
Percent of total CPU time spent waiting for I/O.
Percent of total CPU time used by system processes.
Percent of total CPU time used by user processes.
Percent of CPU time used by user and system processes.
Type
Percent
Percent
Percent
Percent
Percent
Percent
Memory Metrics
Metric Description
MEMORY BUFFERS Amount of memory currently used as a disk buffer cache.
MEMORY CACHE
MEMORY FREE
Amount of cache memory.
Amount of idle memory.
MEMORY TOTAL
MEMORY TOTAL
SWAP
Total amount of physical memory in the system.
Amount of memory used for swap space.
MEMORY USAGE Total amount of memory used by the system, calculated as the total memory minus the amount of free memory.
MEMORY VIRTUAL Amount of virtual memory used.
PROCS SLEEPING
PROCS WAITING
SWAP IN
Number of processes in uninterruptible sleep.
Number of processes waiting for run time.
Amount of memory swapped in from disk per second.
Type
KB
KB
KB
KB
KB
KB
KB
Number
Number
KB/sec
252 Teradata Viewpoint User Guide
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
Metric
SWAP OUT
Description
Amount of memory swapped to disk per second.
Type
KB/sec
Throughput Metrics
Metric
AVG. JOBS LAST
MINUTE
AVG. JOBS LAST
FIVE MINUTES
AVG. JOBS LAST
FIFTEEN MINUTE
Description
Average number of processes running or able to run during the last minute.
Average number of processes running or able to run during the last 5 minutes.
Average number of processes running or able to run during the last 15 minutes.
Type
Number
Number
Number
BLOCKS RECEIVED Number of blocks received from a block device per second.
Number
BLOCKS SENT Number of blocks sent to a block device per second.
Number
Number of context switches per second.
Number CONTEXT
SWITCHES PER
SECOND
INTERRUPTS PER
SECOND
Number of interrupts per second.
Number
Metric Colors
A fixed set of 10 colors is used for the sparkline, performance envelope, and information balloon. Each metric you select is listed below the graph, and its color is determined by the position selected in the PREFERENCES view.
9
10
7
8
3
4
5
6
Metric Position Color Example
1
2
Description
Green
Blue
Gold
Aqua
Pink
Gray
Lime
Brown
Teal
Purple
About the Preferences View
The PREFERENCES view allows you to customize the appearance of the graph.
Teradata Viewpoint User Guide 253
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
In this view, you can:
• Add metrics to monitor and display.
• Delete metrics that you do not want to monitor or display.
• Select the ENABLE check box to plot the metric in the graph.
• Clear the ENABLE check box to remove the metric from the graph, but still list it below the graph.
• Reorder metrics to change their position and color.
• Select systems to monitor and display.
• Set a threshold that helps you track the performance of each metric.
• Set a vertical axis range to limit the maximum value to display.
From the portlet frame, click to access the PREFERENCES view.
Adding Metrics
This task describes how to add metrics that are plotted in the graph.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
254
3
4
5
6
7
8
9
10
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Click to add a metric.
Up to 10 metrics can be listed.
Select a metric from the METRIC list.
[Optional] Select a system from the SYSTEM list.
Note: The SYSTEM list is available when more than one Teradata Viewpoint server is enabled for the Data Collection Service.
[Optional] Enter a THRESHOLD value.
You can change the THRESHOLD settings for the metric at any time.
[Optional] Enter a VERTICAL AXIS RANGE value.
You can change the VERTICAL AXIS RANGE settings for the metric at any time.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
Changing the Metrics Display Order
This task describes how to change the order of the metrics that are listed below the graph.
Reordering the metric list affects which color is assigned to the metric.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
On the metric row, click and drag the row to its new location.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Enabling and Disabling Metrics
This task describes how to enable and disable metrics from the graph. When a metric is disabled, the metric sparkline is not plotted in the graph; however, data points are still being collected, so the metric is included in the list under the graph and can be reactivated at a later time.
1
2
From the portlet frame, click to access the PREFERENCES view.
Select the Metrics tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do one of the following:
• Clear ENABLE on the metric line to disable the metric.
• Select ENABLE on the metric line to enable the metric.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 255
Chapter 25 Viewpoint Monitoring
Viewpoint Monitoring
Deleting Metrics
This task describes how to delete metrics from the graph. When a metric is deleted in the
PREFERENCES view, the metric sparkline is not plotted in the graph, and the metric is not included in the list under the graph.
1
2
3
4
From the portlet frame, click to access the PREFERENCES view.
Select the Metrics tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Click on the metric row of the metric you want to delete.
5
6
The metric row disappears.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
256 Teradata Viewpoint User Guide
CHAPTER 26
Workload Health
Workload Health
The WORKLOAD HEALTH portlet displays workload health information for one system at a time. You choose which system, workloads, and metrics to monitor. Filter and Sort menus allow you to customize the information displayed. Data in the WORKLOAD
HEALTH portlet is refreshed every minute to provide near-real-time reporting.
The WORKLOAD HEALTH portlet displays workloads that:
• Have completed processing according to their Service Level Goals
• Have missed their Service Level Goals
• Are inactive
• Are disabled
• Have no defined Service Level Goals
The <workload name> HEALTH DETAILS view provides detailed metrics for an individual workload.
Workload Health Concepts
What is a Workload?
A workload is a group of queries that share characteristics so that a set of workload management controls can be applied to the group. A workload has working values and defining characteristics that are evaluated during the classification phase of system management.
Workload Examples
Name
DBA_GrandRapids
Characteristics
WD-Accounting-All Requests for the account strings for the entire accounting department. The characteristics are the accountIDs and region identifiers.
Requests submitted by the DBA Department in Grand Rapids. An IP address or user name could be specified as characteristics.
MULTILOAD_SMP Requests that execute the Teradata MultiLoad utility and single-AMP queries. These requests require fast response times.
What is a Service Level Goal?
A Service Level Goal (SLG) measures whether workload management is meeting defined criteria. An SLG can be expressed as a number or percentage. SLGs are defined for logging
Teradata Viewpoint User Guide 257
Chapter 26 Workload Health
Workload Health and reporting purposes. There are no provisions in the Teradata Database to enforce these goals.
Not all workloads need an SLG. In general, it is good practice to establish SLGs for tactical workloads. However, low-priority, background workloads do not need an SLG.
What is an Enforcement Priority?
When a workload is created, it is assigned an enforcement priority (EP) and an allocation
group (AG). An EP is a ranking given to establish a processing order for the queries running within the workload. Each AG has only one EP, and an EP can have multiple AGs. Teradata
Database uses the following EPs:
Tactical High-priority, critical queries with a short response-time requirement for single or few-AMP queries or all-AMP queries that consume less than 1 CPU second per node.
Priority
Normal
Important queries that might need extra resources.
Default enforcement priority for queries.
Background Low-priority queries with no response-time requirements or Service Level
Goals.
About the Workload Health View
Use the WORKLOAD HEALTH view to display the health status of one or more workloads.
Workload health is determined in relation to a Service Level Goal (SLG).
258
The following list describes the features in this view:
• System name in the portlet frame, color-coded to red if a workload has missed its SLG
• Workload names
• Workload health, presented using color, icons, and predefined states
• Workload sort and filter capabilities
• Portlet rewind and share capabilities
Click a workload icon to go to the <workload name> HEALTH DETAILS view.
Note: The <workload name> HEALTH DETAILS view is not available for workloads having a health state of NO_DATA.
Teradata Viewpoint User Guide
Chapter 26 Workload Health
Workload Health
Workload Health States
Workload health is described using a set of icons and predefined states. Health states are listed in the default sort order.
Icon Text
Color
Red
State
MISSED_SLG
Description
Workload missed its SLG for a period of time, based on the enforcement priority:
• Tactical: last minute
• Priority: last 30 minutes
• Normal and Background: last 60 minutes
Blue MET_SLG
Black NO_SLG
Workload met its enforcement-priority Service Level
Goals.
Note: This health state is determined by comparing the measured query Response Time with the expected
Response Time and Percent SLG metrics.
No Service Level Goals have been set for this workload.
No data is available for this workload.
Blue NO_DATA
Blue DISABLED
Gray INACTIVE
The workload has been disabled.
The workload is inactive.
Selecting Filter Criteria
1
Click Filter.
The Filter Workloads dialog box appears.
2
To specify the filter criteria, do any of the following:
Teradata Viewpoint User Guide 259
Chapter 26 Workload Health
Workload Health
• Select the All Enforcement Priorities check box or click to display the enforcement priority list and select at least one enforcement priority.
• Select the All Health States check box or click to display the health state list and select at least one health state.
• Select the Name check box and enter a workload name or name pattern.
Setting Sort Criteria
1
Click Sort.
The Sort menu appears.
2
To specify the sort criteria, do one of the following:
• Click Missed SLG to sort workloads into workload health state groups in alphabetical order by workload name:
• MISSED_SLG
• MET_SLG
• NO_SLG
• NO_DATA
• INACTIVE
• DISABLED
• Click Name to display workloads in alphabetical order by workload name, regardless of workload health state.
About the Workload Health Details View
The <workload name> HEALTH DETAILS view displays metrics for a single workload. Use the PREFERENCES view to select the metrics. This view appears after you click the workload icon, name, or information balloon for a workload in the WORKLOAD HEALTH view.
Note: The <workload name> HEALTH DETAILS view is not available for workloads having a health state of NO_DATA.
260 Teradata Viewpoint User Guide
Chapter 26 Workload Health
Workload Health
Metrics are arranged in a two-column format:
• Metric names
• Sparkline graphs
As you mouse over the sparklines, information balloons display event information. Each sparkline ends with a percentage or a value, depending on the metric.
About Workload Metrics Graphs
Sparkline graphs illustrate workload performance metrics.
Solid lines represent the current data for their respective metric.
On a single-sparkline graph (for example, the MAX RESPONSE metric), the solid line represents current data for the metric, and the greyed skyline represents the past averages for that same metric.
On a multi-sparkline graph, a metric can be expressed in more than one value. When you mouse over the sparkline, the color of the metric name, end data points, and information balloons match.
Teradata Viewpoint User Guide 261
Chapter 26 Workload Health
Workload Health
A dotted line in the graph is called the SLG reference line. Data points above the SLG reference line are color-coded in red.
262
Workload Metrics
Metric
Aborted Queries
Active Queries
Description
Number of aborted queries in the last 60 seconds.
Number of active queries in the last 60 seconds. This metric is a default for the Priority, Normal, and
Background EPs.
Arrivals
Arrivals Throttled
Avg CPU-SEC per Query Average CPU seconds per completed queries is a default metric for the Tactical enforcement priority, providing throughput and processing information.
Avg Response & Delay
Time
Default metric for all EPs.
Cumulative CPU
Number of queries arriving in the last 60 seconds.
Historical data is not displayed for this metric. This is the default metric for all EPs.
Percentage of queries throttled upon arrival in the last
60 seconds.
Delayed Queries
Cumulative CPU percentage for all queries in the last
60 seconds. This metric is a default for the Priority,
Normal, and Background EPs.
Number of queries in the delay queue in the last 60 seconds. This metric is a default metric for Priority,
Normal, and Background EPs.
Type
Number
Number
Number
Percent
Number
Number
Percent
Number
Teradata Viewpoint User Guide
Chapter 26 Workload Health
Workload Health
Metric
Exceptions
Description
Number of queries classified as exceptions in the last
60 seconds.
Max CPU-SEC per Query Maximum CPU seconds used by completed queries is a default metric for the Tactical EP.
Maximum Response Time Default metric for the Tactical EP.
Queries Throttled Number of queries throttled in the workload in the last 60 seconds.
Rejected Queries
Throughput
Number of rejected queries in the last 60 seconds.
Number of completed queries in the last 60 seconds.
This metric does not display historical data.
Type
Number
Number
Number
Number
Number
Number
About the Preferences View
The PREFERENCES view allows you to customize the WORKLOAD HEALTH portlet.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
System and Workloads Choose a system and its workloads to monitor.
Metrics-Tactical Select metrics for workloads in the Tactical enforcement priority.
Metrics-Priority
Metrics-Normal
Select metrics for workloads in the Priority enforcement priority.
Select metrics for workloads in the Normal enforcement priority.
Metrics-Background Select metrics for workloads in the Background enforcement priority.
Trend Interval
Past Average
Set the time period for calculating each trend interval.
Choose the time period for which a historical average is calculated.
Selecting a System and Workloads to Monitor
Use the System and Workloads tab in the PREFERENCES view to select the system and which of its workloads to monitor.
1
2
3
4
5
From the portlet frame, click to access the PREFERENCES view.
Click the System and Workloads tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a system from the list.
Select the check box for each workload you want to monitor.
6
7
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 263
Chapter 26 Workload Health
Workload Health
Setting Enforcement Priority Metrics
For each enforcement priority group, you can select and order metrics for display from the
PREFERENCES view. Choose from a defined list of metrics.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab for an enforcement priority group.
The Preview pane uses sample data to show how metric rows are displayed in the summary view.
264
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do any of the following to change the way metric rows are displayed:
• Add a metric row. Drag a metric from the Select metrics for display list to the
Preview pane.
• Remove a metric row. Drag a metric from the Preview pane to the Metric Removal pane.
• Change metric row order. Drag a metric already in the Preview pane to a new location in the pane (up or down).
Note: Changes to the metrics affect only the system currently selected, provided that the metrics are available on that system.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting the Workload Trend Interval
Use the Trend Interval tab in the PREFERENCES view to set the length of time used to plot sparkline metrics in the portlet details view.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Trend Interval tab.
Teradata Viewpoint User Guide
Chapter 26 Workload Health
Workload Health
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
In the dialog box, select an Interval.
The default is 24 hours.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Past Averages
Use the Past Averages tab in the PREFERENCES view to specify the number of weeks of data points used to calculate the average values displayed in metric graphs.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Past Averages tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter the number of weeks (1 to 99 weeks).
The default is 2 weeks.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 265
Chapter 26 Workload Health
Workload Health
266 Teradata Viewpoint User Guide
CHAPTER 27
Workload Monitor
Workload Monitor
The WORKLOAD MONITOR portlet allows you to monitor workload activity, allocation group, and session data in Teradata Database.
The WORKLOAD MONITOR provides:
• Multiple summary and details views for presenting information
• A state matrix icon that displays the status of the Teradata Database system
• A choice of data sampling periods
• The ability to filter workloads and sort columns
Workload Monitor Concepts
What is a Workload?
A workload is a group of queries that share characteristics so that a set of workload management controls can be applied to the group. A workload has working values and defining characteristics that are evaluated during the classification phase of system management.
Workload Examples
Name Characteristics
WD-Accounting-All Requests for the account strings for the entire accounting department. The characteristics are the accountIDs and region identifiers.
DBA_GrandRapids Requests submitted by the DBA Department in Grand Rapids. An IP address or user name could be specified as characteristics.
MULTILOAD_SMP Requests that execute the Teradata MultiLoad utility and single-AMP queries. These requests require fast response times.
What is a Service Level Goal?
A Service Level Goal (SLG) measures whether workload management is meeting defined criteria. An SLG can be expressed as a number or percentage. SLGs are defined for logging and reporting purposes. There are no provisions in the Teradata Database to enforce these goals.
Not all workloads need an SLG. In general, it is good practice to establish SLGs for tactical workloads. However, low-priority, background workloads do not need an SLG.
Teradata Viewpoint User Guide 267
Chapter 27 Workload Monitor
Workload Monitor
What is an Enforcement Priority?
When a workload is created, it is assigned an enforcement priority (EP) and an allocation
group (AG). An EP is a ranking given to establish a processing order for the queries running within the workload. Each AG has only one EP, and an EP can have multiple AGs. Teradata
Database uses the following EPs:
Tactical High-priority, critical queries with a short response-time requirement for single or few-AMP queries or all-AMP queries that consume less than 1 CPU second per node.
Priority
Normal
Important queries that might need extra resources.
Default enforcement priority for queries.
Background Low-priority queries with no response-time requirements or Service Level
Goals.
Workload Metrics
Metric
Active Requests
Average Response Time and Average Delay Time
Description
Number of active requests in the last 60 seconds. This is a default metric for the Priority, Normal, and
Background enforcement priorities.
Average response time and the average delay time for all active requests. This is a default metric for all enforcement priorities.
Type
Number
Number
Maximum Response Time Maximum response time for all active requests. This is a default metric for the Tactical enforcement priority.
Delayed Queries Number of queries in the delay queue in the last 60 seconds. This metric is a default metric for Priority,
Normal, and Background enforcement priorities.
Number
Number
Average time that queries spend in the delay queue.
Number Average Delay Queue
Time
Average CPU-SEC per
Request
Average CPU time in seconds of workload requests.
This is a default metric for the Tactical enforcement priority.
Number
Maximum CPU-SEC per
Request
Maximum CPU time in seconds of workload requests.
This is a default metric for the Tactical enforcement priority.
Arrivals and Completions Number of queries arriving and completing in the last
60 seconds. This metric does not display historical data. This is a default metric for all enforcement priorities.
Impact CPU-SEC Maximum amount of CPU time used by a workload compared to the total CPU used by all workloads on the system.
Number
Number
Number
268 Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
Metric
Cumulative CPU
Description
Cumulative CPU percentage for all queries in the last
60 seconds. This is a default metric for the Priority,
Normal, and Background enforcement priorities.
Type
Percent
What is an Exception?
A workload management exception occurs when a query executes outside of the system regulation that is currently in effect. The WORKLOAD MONITOR portlet reports on exceptions for CPU or I/O skew, an excessive number of concurrent workloads, or queries that are reassigned or reclassified to another workload.
Working with Workload Monitor Views
The WORKLOAD MONITOR portlet provides summary views to help you identify issues in workload management.
• Use the Dynamic Pipes view to analyze workload data in near-real time at each system management point of control. You can choose the data sampling period and workload filter criteria. Workloads can be displayed within their enforcement priority (EP).
• Use the Static Pipes view to compare summary and detail workload metrics. Workloads can also be viewed within their EP, and data can be sorted by column. You can also determine whether system resources within an EP are being skewed to a workload by comparing the statistics of a particular workload to other workloads within the EP.
• Use the Distribution view to review workload information within the context of its allocation group (AG). Mouse over the pie charts to see CPU consumption for workloads within an AG compared to the relative weight of the AG. Colors relate pie chart segments to each other and to list information. Use this view to determine:
• Why a workload is over-consuming system resources, causing other workloads to miss their SLGs
• Why a workload is not receiving the system resources required to complete processing
About the State Matrix
The Teradata Database state matrix icon in the toolbar shows changes in state, planned environment, or health condition during the cumulative sampling period.
The state matrix icon uses color to show the following:
Dark blue Active-state cell.
Medium blue Previously active state cell
Light blue Inactive-state cell
Note: During a state change, the cell representing the previous state changes from dark blue to medium blue. If there was a second state change during the sampling period, the previous state cell is shown in light blue.
The number of cells in the state matrix icon depends on the state matrix of the monitored system. If a one-by-one state matrix is configured, the state matrix icon appears as one active cell:
Teradata Viewpoint User Guide 269
Chapter 27 Workload Monitor
Workload Monitor
When you mouse over the state matrix icon, information balloons show detail information and the last state change if there was a state change within the sampling period.
270
Selecting a Summary View
This task describes how to select a summary view. The WORKLOAD MONITOR portlet saves the active view from your last session to open for your next session.
1
•
•
•
Click one of the following:
to go to the Dynamic Pipes view.
to go to the Static Pipes view.
to go to the Distribution view.
Setting the Sampling Period
The sampling period you select applies to all views that contain a sampling period menu. The
Cumulative System Data menu is dimmed if the selected sampling period has not been reached. The default is 60 minutes. Sampling period totals are updated during the portlet refresh, which is every 60 seconds.
Note: Cumulative data is not affected by workload filter criteria.
1
Select a sampling period:
• In the Dynamic Pipes and Static Pipes views under Cumulative System Data From
Last.
• In the Distribution view under CPU Consumption Per Workload From Last.
Workload Monitor Icons
This topic describes the icons used in the WORKLOAD MONITOR portlet. You can click on the values associated with these icons to see to the details views.
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
Icon
Teradata Viewpoint User Guide
Description
Requests arriving into system management.
Requests that were not allowed to continue processing. This icon appears with the following values:
• The number of rejected requests by system filters
• The number of rejected requests by system throttles
• The number of aborted requests that were caused by exceptions
Requests that have been allowed to continue processing after a warning message has been written to the system log file.
Requests that use exception processing. This icon appears with these values:
• The total number of workload exceptions in the sampling period
• The number of requests reclassified to a different EP
• The number of requests that have been aborted
Completed requests. These requests no longer require system resources.
271
Chapter 27 Workload Monitor
Workload Monitor
Navigating to Details Views
Many WORKLOAD MONITOR views provide detailed information and can be accessed from one or more views. To display system data, click the values associated with the arrivals, exceptions, delayed, and completions icons in the Dynamic Pipes, Static Pipes, or <workload
name> (workload pipe) view.
1
To display data for an individual workload, click the workload name in any of the toplevel views and do one of the following:
• Click Cumulative to display cumulative values for the selected sampling period.
• Click Snapshot to display current values and the <workload name> (workload pipe) view.
• Click Trends 24hrs to display sparkline metrics for the workload.
• Click the Cumulative Workload Data to change the sampling period.
272
2
3
To display system data, click the values associated with the arrivals, exceptions, delayed, and completions icons in the Dynamic Pipes, Static Pipes, or <workload name>
(workload pipe) view.
To display workload data and allocation group, do one of the following:
• Click the AG name in the Distribution view.
• Click the AG name button in the <workload name> (workload pipe) view.
Workload Monitor Details View Catalog
This topic lists the details views available in the WORKLOAD MONITOR portlet. Mouse over the error description columns to view the full message.
View Name
ABORTED BY
WORKLOAD
EXCEPTION
Column and Icon Data
Log time, session ID, username, account, error code, and error description
Accessed from These Views
<workload name> (workload pipe cumulative and details views)
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
View Name
<allocation
group> (allocation group pipes view)
ARRIVALS,
COMPLETIONS
CURRENT
ACTIVE
CURRENT
DELAYED
EXCEPTIONS
(summary view)
EXCEPTIONS
(details view)
Column and Icon Data
Enforcement priority, allocation group name, workload name, workload throttle limit, cumulative delayed at workload throttle, percentage of AG CPU for each workload
(sparkline), and percentage of total CPU for the
AG
Workload name, arrival count, completed count, percent completed, abort count, delay count, exception count, and percentage of workloads requests that have exceeded their SLGs
Session ID, workload name, username, account,
CPU time, I/O count, and either elapse time or delay time
Accessed from These Views
DISTRIBUTION, <workload
name> (workload pipe cumulative and snapshot views)
WORKLOAD MONITOR
(Dynamic Pipes and Static
Pipes views), <workload
name> (workload pipe)
WORKLOAD MONITOR
(Dynamic Pipes and Static
Pipes views), <workload
name> (workload pipe view), <allocation group>
(allocation group pipes view)
Session ID, workload name, username, account,
CPU time, I/O count, and either elapse time or delay time
Workload name, total exception count, aborted count, reclassified count, and logged (only) count
Log time, session ID, username, account, current status, rule name, error code, and error description
Log time, session ID, username, account, error code, and error description
WORKLOAD MONITOR
(Dynamic Pipes and Static
Pipes views)
WORKLOAD MONITOR
(Dynamic Pipes and Static
Pipes views)
EXCEPTIONS (details view), <workload name>
(workload pipe view)
<workload name> (workload pipe view), <allocation
group> (allocation group pipes view)
REJECTED AT
SYSTEM
FILTERS,
REJECTED AT
SYSTEM
THROTTLES,
REJECTED AT
WORKLOAD
THROTTLES
WARNINGS AT
SYSTEM
FILTERS,
WARNINGS AT
SYSTEM
THROTTLES,
WARNINGS AT
WORKLOAD
THROTTLES
Log time, session ID, username, account, rule name that caused the warning or rejection, error code, and error description
WORKLOAD MONITOR
(Dynamic Pipes and Static
Pipes views), <workload
name> (workload pipe view), <allocation group>
(allocation group pipes view)
Teradata Viewpoint User Guide 273
Chapter 27 Workload Monitor
Workload Monitor
View Name
<workload name>
(workload pipe cumulative view)
Column and Icon Data
Enforcement priority, allocation group, arrivals, workload throttle limit, cumulative delayed at workload throttle, exceptions, reclassified into the workload, reclassified out of the workload, and completions
Accessed from These Views
WORKLOAD MONITOR
(Dynamic Pipes, Static Pipes, and Distribution views)
About the Dynamic Pipes View
The Dynamic Pipes view helps you analyze workloads. You can access cumulative, snapshot, and trend data for each workload. Use the Filter menu to modify the active workload display. If there are more than 18 workloads, they are grouped by EP.
Use this view to see:
• Workloads that missed their SLGs
• Requests that are delayed or rejected at system filters and system throttles
• Delay queue that is growing. A pulsing indicator appears near the workload name when a workload is adding requests to the delay queue.
274
Selecting Filter Criteria
1
Click in the workload pane.
The Filter menu appears.
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
2
3
To specify the filter criteria, do any of the following:
• Select the Group by enforcement priority check box to group workloads by their enforcement priority.
• Select the All Enforcement Priorities check box or click to display the enforcement priority list. Select at least one enforcement priority.
• Select the Missed SLG check box to display only those workloads that missed their
SLGs.
• Select the Name check box and enter a workload name or name pattern.
• Select the Active Workloads check box to display only those workloads that were active within the sampling period.
Click X to close the menu.
The filter criteria appear at the top of the workload pane.
About the Static Pipes View
Use the Static Pipes view to display workload metrics. Use the PREFERENCES view to add and delete columns.
The Workloads tab displays all active workloads within the Cumulative System Data sampling period, the workload EP, and metrics. The display is organized in the following column groups:
CUMULATIVE Number of completed workload requests, the percentage which met their
SLGs, and the CPU percentage. The following metrics can be added:
• Arrival count
• Aborted count
• Exception count
• Average delay time
CURRENT Total number of active requests classified into the workload. The current delayed count metric can be added.
LAST 60 MIN Sparkline representing the total number of requests classified into the workload that were in the delay queue in the last 60 minutes. You can
Teradata Viewpoint User Guide 275
Chapter 27 Workload Monitor
Workload Monitor also add a sparkline for the total number of active requests in the last 60 minutes.
The Enforcement priorities tab displays all active workloads within the Cumulative System
Data sampling period by EP. The data is organized under the following column groups:
CUMULATIVE Percentage of completed requests within the EP, the total number of workloads that met their SLGs, and the CPU percentage.
CURRENT Total number of active requests classified into one or more workloads in the EP.
About the Distribution View
The Distribution view displays workload CPU consumption percentages, allowing you to compare the CPU consumption for workloads in an AG to the relative weight of the AG within the resource partition.
Use this view to see:
• A pie chart graph that uses color and information balloons to display CPU consumption data for each workload that was active within the Cumulative System Data sampling period. As you mouse over a pie chart section, workloads highlight in the workload list.
Idle CPU time is shown if applicable during the sampling period.
276 Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
• A pie chart graph that uses color and information balloons to relate the relative weight of each pie section to the AG in the AG list. As you mouse over a pie chart section, the AG highlights in the AG list.
The expand ( ) and collapse ( ) list controls can be used to change the length of the portlet.
Minimizing the lists save space on the portal page.
About the Request Details View
When viewing a request, you can see detailed information from the following tabs:
Overview Key statistics for a session. Any value exceeding the thresholds is highlighted.
SQL SQL for the selected query.
Explain Explain steps for the query, including step statistics and explain text.
Blocked By Details about other queries that are blocking this query.
Note: This tab is available when the selected query is blocked.
Query Band Displays the query band name and value for the selected query.
Details View Metrics
Query Information
Metric
STATE
Description
Query state, such as ACTIVE, BLOCKED, TERMINATE
Type
Character
Teradata Viewpoint User Guide 277
Chapter 27 Workload Monitor
Workload Monitor
Metric
TIME IN STATE
Description
How long the query has been in the current state, displayed as
HH:MM:SS
TOTAL DURATION How long the query has run, displayed as HH:MM:SS
CPU
CPU delta
Total CPU usage time, in seconds, consumed by the query
Total CPU usage time consumed, in seconds, since the last sample
I/O
I/O delta
Number of I/O operations the query performed
I/O count since the last sample
UNNECESSARY I/O All AMP I/O divided by all AMP CPU, displayed in milliseconds, to reveal large amounts of I/O occurring over a short period of time
IMPACT CPU Total CPU seconds consumed across all AMPs that are active for this session
CPU SKEW
I/O SKEW
SPOOL
TEMP SPACE
WORKLOAD
PJI
CPU USE
CPU skew during the last sample
I/O skew during the last sample
Amount of spool space the query is using
Amount of temp space the query is using
Workload where the query is actively running
Ratio of the CPU milliseconds per I/O for the query, where a larger Product Join Index number indicates system performance degradation
Type
Number
Number
Number
Number
Number
Number
Number
Number
Percent
Percent
Number
Number
Character
Number
Percent of the total amount of available CPU used by the query Percent
Session Information
Metric
USER
ACCOUNT
SOURCE
PARTITION
REQUESTS
Description
Name of the user who submitted the query
Account of the user who submitted the query
Source details, such as application name, IP address, and host user name
Partition in which the query is running
Number of queries submitted by the session
Type
Character
Character
Character
Character
Number
Symbol Reference
The following symbols appear in summary and details views:
Symbol Name Definition
ABORTING Query has been aborted, and changes are being rolled back.
ACTIVE Query is running.
278 Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
Symbol Name
BLOCKED
DELAYED
IDLE
Definition
Query is waiting for a lock held by another query.
Query is in a delay queue waiting to run.
No query is running.
OTHER
PARSING
Query is in an unknown state.
Query is being parsed before running.
QTDELAYED Query is waiting for rows to be inserted into a queue table.
RESPONSE Query is returning results to the user.
SESDELAYED Query is delayed because a utility limit has been exceeded in FastLoad,
MultiLoad, FastExport, or ARC.
About the Details Overview Tab
The Overview tab provides detailed information about key metrics for the selected session and its queries. The metric values displayed provide a snapshot of Teradata Database system status. Metrics that exceed preset thresholds are highlighted.
About the Details SQL Tab
The SQL tab displays the SQL for the selected query. This information is read-only.
Teradata Viewpoint User Guide 279
Chapter 27 Workload Monitor
Workload Monitor
280
About the Details Explain Tab
The Explain tab displays an abbreviated version of the Step statistics and the Explain text that result from an Explain request in an SQL session. This information is read-only, and no actions are available from this tab. The Explain tab displays completed steps at the top of the list and future steps at the bottom. The tab periodically refreshes to display updated information. Each Explain step is uniquely identified with a number where the background of the number box indicates status.
• Completed steps are at the top of the list and indicated by a black number box.
• Active steps are indicated by a pulsating number box (flashes gray and white).
• Steps to run are at the bottom of the list and indicated by a white number box.
Each numbered step includes:
EST. TIME
EST. I/O
Estimated execution time for the step.
Estimated number of I/Os for the step.
ACTUAL TIME Actual CPU time consumed by the step, or blank if the step has not run.
ACTUAL I/O Actual number of I/Os for the step, or blank if the step has not run.
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
About the Details Blocked By Tab
The Blocked By tab displays details about other queries that are blocking this query. This information is read-only, and no actions are available from this tab. If this tab is unavailable, the selected query is not blocked. The Blocked By tab displays:
USERNAME Name of the user that is running the query that holds the lock.
HOST Host ID that is logged on to the session.
SESSION ID Session ID in which the blocking query was run.
LOCK TYPE Type of lock.
STATUS
LOCKED
Lock status.
Name of the locked object.
About the Details Query Band Tab
The Query Band tab displays the query band name and value for the selected query. This information is read-only. For each query, the QUERY BAND tab displays:
Teradata Viewpoint User Guide 281
Chapter 27 Workload Monitor
Workload Monitor
NAME
VALUE
The name of the query band.
The value of the query band.
About the Tools Menu
The Tools menu allows you to manage queries and sessions.
282
Use the Tools menu to balance system resources:
Abort
Change Priority
Change Workload
Release Query
Abort the selected query or session.
Change the priority of the selected query or session.
Change the workload of the selected query or session.
Release the selected query from a delay queue.
Aborting a Query or a Session
This task describes how to abort a query or a session of queries that is blocking other queries or consuming too many resources.
1
2
3
4
5
From the summary view, click the row of the query you want to abort.
Click Tools > Abort.
[Optional] Log in.
Click Next.
Select one of the following:
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
6
7
• Abort Query to abort the selected query.
• Abort Session to abort the selected query and log off the session.
Click Next.
Click Next to confirm your selection.
Changing the Priority of a Query or Session
This task describes how to change the priority of a query or session to allow higher priority queries to run or to balance session resources.
Note: This menu item is only available when workloads are not enabled and the system being monitored supports this feature.
1
2
3
4
5
6
7
8
9
10
From the summary view, click the row of the query with a priority that needs to change.
Click Tools > Change Priority.
[Optional] Log in.
Click Next.
From the list of accounts that have been assigned to the user, select an account to copy the account name to the Edit new account string box.
[Optional] Edit the account string or enter a new account string.
Click Next.
Select one of the following:
• Move just this query to change the priority of the selected query.
• Move this query and all future queries associated with this session to change the priority of the selected query and all subsequent queries in the current session.
Click Next.
Click Next to confirm your selection.
Changing the Workload of a Query or Session
This task describes how to change the workload of a query or session to either allow higher priority workloads to run or to balance workload resources.
Note: This menu item is only available when workloads are enabled and the system being monitored supports this feature.
1
2
3
4
5
6
7
From the summary view, click the row of the query with the workload that needs to change.
Click Tools > Change Workload.
[Optional] Log in.
Click Next.
[Optional] Select a different workload from the list.
Click Next to confirm your selection.
Select one of the following:
Teradata Viewpoint User Guide 283
Chapter 27 Workload Monitor
Workload Monitor
8
9
• Move just this query to change the workload of the selected query.
• Move this query and all future queries associated with this session to change the workload of the selected query and all subsequent queries in the same session.
Click Next.
Click Next to confirm your selection.
Releasing a Query
This task describes how to release a query that is queued and waiting to run.
1
2
3
4
5
From the summary view, click the row of the query you want to release.
Click Tools > Release Query.
[Optional] Log in.
Click Next.
Click Next to confirm your selection.
About the Preferences View
The PREFERENCES view allows you to customize the WORKLOAD MONITOR portlet.
From the portlet frame, click to access the PREFERENCES view and the following tabs:
System and Workloads Choose a system and its workloads to monitor.
Columns Select columns to display. Use this interface to add, move, or delete columns from the view.
Metrics-Tactical
Metrics-Priority
Select metrics for workloads in the Tactical enforcement priority.
Select metrics for workloads in the Priority enforcement priority.
Metrics-Normal Select metrics for workloads in the Normal enforcement priority.
Metrics-Background Select metrics for workloads in the Background enforcement priority.
Trend Interval
Past Average
Set the time period for calculating each trend interval.
Choose the time period for which a historical average is calculated.
Selecting a System and Workloads to Monitor
Use the System and Workloads tab in the PREFERENCES view to select the system and which of its workloads to monitor.
1
2
3
4
From the portlet frame, click to access the PREFERENCES view.
Click the System and Workloads tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Select a system from the list.
284 Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
5
Select the check box for each workload you want to monitor.
6
7
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Selecting Columns
Use the Columns tab in the PREFERENCES view to add or remove columns from the view.
The workload-name column is required. The column can be dragged to be removed but always appears in the table and reappears when the PREFERENCES view is opened again.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Columns tab.
The Preview pane uses sample data to show how metric rows are displayed in the summary view.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Change which columns are displayed by doing one or more of the following:
• Add a column. Select a column title and drag it from the Available Columns list into the Default display pane.
• Remove a column. Select a column from the Default display pane, and drag it to the
Drag columns here to remove from portlet pane.
Note: The order of the columns in the portlet view does not match the column order in the Default display pane. Columns are grouped by the sampling rate of the metric.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Enforcement Priority Metrics
For each enforcement priority group, you can select and order metrics for display from the
PREFERENCES view. Choose from a defined list of metrics.
Teradata Viewpoint User Guide 285
Chapter 27 Workload Monitor
Workload Monitor
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Metrics tab for an enforcement priority group.
The Preview pane uses sample data to show how metric rows are displayed in the summary view.
286
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Do any of the following to change the way metric rows are displayed:
• Add a metric row. Drag a metric from the Select metrics for display list to the
Preview pane.
• Remove a metric row. Drag a metric from the Preview pane to the Metric Removal pane.
• Change metric row order. Drag a metric already in the Preview pane to a new location in the pane (up or down).
Note: Changes to the metrics affect only the system currently selected, provided that the metrics are available on that system.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting the Workload Trend Interval
Use the Trend Interval tab in the PREFERENCES view to set the length of time used to plot sparkline metrics in the portlet details view.
1
2
3
4
From the portlet frame, click to access the PREFERENCES view.
Click the Trend Interval tab.
[Optional] Click Clear Defaults to clear all default settings for this portlet.
In the dialog box, select an Interval.
The default is 24 hours.
Teradata Viewpoint User Guide
Chapter 27 Workload Monitor
Workload Monitor
5
6
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Setting Past Averages
Use the Past Averages tab in the PREFERENCES view to specify the number of weeks of data points used to calculate the average values displayed in metric graphs.
1
2
From the portlet frame, click to access the PREFERENCES view.
Click the Past Averages tab.
3
4
5
6
[Optional] Click Clear Defaults to clear all default settings for this portlet.
Enter the number of weeks (1 to 99 weeks).
The default is 2 weeks.
[Optional] Select the Use these settings as defaults check box to save the current settings as the default configuration each time you add this portlet to the portal page.
Click OK.
Teradata Viewpoint User Guide 287
Chapter 27 Workload Monitor
Workload Monitor
288 Teradata Viewpoint User Guide
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
Document public link
Advertisement
Key features
Provides a portal for viewing and managing Teradata system data
Uses a page metaphor for displaying and updating portlets
Allows user to customize the portal display
Offers filtering and sorting tools for data analysis
Frequently asked questions
Open a browser, enter the address for your Teradata Viewpoint portal, and log on using your company-provided username and password.
Portlets are system management tools within Teradata Viewpoint. You can add them to the active page from submenus or by searching for a specific portlet name.
You can add and arrange portal pages, change page names, and reposition portlets on the page.
