Getting Started with Cloudera Navigator
Cloudera Navigator features and functions are available through the Cloudera Navigator console, a web-based user interface provided by the host configured with the Navigator Metadata Server role (daemon). The Cloudera Navigator console invokes the REST APIs exposed by the web service provided by the Navigator Metadata Server role instance. The APIs can be called directly by in-house, third-party, and other developers who want to further automate tasks or implement functionality not currently provided by the Cloudera Navigator console. This topic discusses both of these interfaces to the Cloudera Navigator metadata component.
The following steps assume that the Cloudera Navigator data management component is running, and that you know the host name and port of the node in the cluster configured with the Navigator Metadata Server role. See Cloudera Installation and Cloudera Administration guides for more information about setting up Cloudera Navigator.
Continue reading:
Cloudera Navigator Console
The Cloudera Navigator console is the web-based user interface that provides data stewards, compliance groups, auditing teams, data engineers, and other business users access to Cloudera Navigator features and functions.
The Cloudera Navigator console provides a unified view of auditing, lineage, and other metadata management capabilities across all clusters managed by a given Cloudera Manager instance. That is, if the Cloudera Manager instance manages five clusters, the Cloudera Navigator console can obtain auditing, lineage, and other metadata for the same five clusters. Cloudera Navigator uses its technical metadata gathering feature to keep track of which cluster originates the data.
Accessing the Cloudera Navigator Console
Open the Cloudera Navigator console in a browser at port 7187 on the host where the Navigator Metadata Server instance is running:
http://fqdn-1.example.com:7187/login.htmlIn this example, node 1 of the cluster is running the Navigator Metadata Server role, hosted on the default port 7187. The login page displays. Log in to the Cloudera Navigator console using the credentials assigned by your administrator.
Cloudera Manager users with the role of Navigator Administrator (or Full Administrator) can also access Cloudera Navigator console from the Cloudera Manager Admin Console.
- Open your browser.
- Navigate to the Cloudera Manager Admin Console.
- Log in as either Navigator Administrator or Full Administrator.
- From the menu, select .
- Select Cloudera Navigator from the menu.
- Log in to the Cloudera Navigator console.
Displaying Documentation
You can open the Cloudera Data Management guide from the Cloudera Navigator console from the Help menu.
Displaying Version Information
To display the version and build number for the Cloudera Navigator data management component, click About in the menu.
The versions for both Cloudera Navigator and the associated Cloudera Manager instance display.
Cloudera Navigator APIs
Cloudera Navigator exposes REST APIs on the host running the Navigator Metadata Server role. In-house, third-party, and other developers can use the APIs to provide functionality not currently available through the Cloudera Navigator console or to customize their users' experience.
The APIs are used by the Cloudera Navigator console at runtime as users interact with the system. The Cloudera Navigator console has a debug mode that captures API calls and responses to a file that can then be downloaded and analyzed. See Using Debug Mode for details.
Documentation and a brief tutorial for the Cloudera Navigator APIs are available on the same node of the cluster that runs the Navigator Metadata Server role. These are also accessible from the Cloudera Navigator console. Example pathnames for direct access (outside the Cloudera Navigator console) are shown in the table.
Resource | Default location |
---|---|
APIs | http://navigator-host:port/api/vn/operation |
API Documentation | http://navigator-host:port/api-console/index.html |
API Usage Tutorial | http://navigator-host:port/api-console/tutorial.html |
Operations on the API are invoked using the following general pattern:
http://navigator-host:port/api/vn/operation
The n in vn for the APIs represents the version number, for example, v11 for the Cloudera Navigator version 2.11.x. The API version number is located at the bottom of the Cloudera Navigator API documentation page.
The API uses HTTP Basic Authentication and accepts the same users and credentials that have access to the Cloudera Navigator console.
The resources listed in the table are aimed at technical and general audiences for Cloudera Navigator Data Management. The GitHub repository is aimed at developers.
Resource | Default location |
---|---|
GitHub cloudera/navigator-sdk | Cloudera Navigator SDK is a client library that provides functionality to help users extract metadata from Navigator and to enrich the metadata in Navigator with custom metadata models, entities, and relationships. |
Cloudera Community Data Management forum | Cloudera Community > Data Management > Data Discovery, Optimization forum for Cloudera Navigator users and developers. |
Cloudera Engineering Blog | In-depth technical content provided by Cloudera engineers about components and specific subject areas. |
Using Debug Mode
Cloudera Navigator console debug mode captures API responses and requests during interaction with the server. Use debug mode to facilitate development efforts or when asked by Cloudera Support to troubleshoot issues.
To follow these steps you must be logged in to the Cloudera Navigator console.
Use Debug Mode to Collect Files for Troubleshooting
The general process for obtaining debug files to send to Cloudera Support is as follows:
- Navigate to the Cloudera Navigator console menu item or page for which you want to obtain debug information.
- Enable debug mode.
- Reload the page and perform the specific action. For example, if you need to send a debug file to Cloudera Support for an error message that displays when you click on an entity in one of the charts, perform that action to raise the error message.
- Download the debug file or files. Each time the counter changes, the content of the debug file content changes, so you should download each time the counter updates.
- Disable debug mode.
Enable Debug Mode
- Log in to the Cloudera Navigator console.
- Select
The Cloudera Navigator consoles displays a notification message in the bottom right of the page:
Notice the links to Disable and Download debug file, which you can use at any time to do either. Do not disable debug mode until you have downloaded the debug file you need.
.
- Reload the browser page.
The counter n displays the number of API calls captured in the debug file for the current session interaction. Here is
an example from a downloaded debug file showing one of the responses after reloading the page:
Download Debug File or Files
As you perform actions with the Cloudera Navigator console, the counter refreshes and keeps tracks of current calls only (stateless nature of REST). In other words, download the debug file for any given action or selection that you want to examine.
- Enable Debug Mode if you haven't already.
- Click the Download debug file link in the debug-enabled notification message, bottom right corner of the page.
- Save the file to your local workstation.
api-data-navigator-host-yyyy-mm-ddThh-mm-ss.jsonFor example:
api-data-node01.example.com-2017-06-15T09-00-32.json
Disable Debug Mode
- Click the Disable debug mode link in the notification message box.
- Select .
<< Cloudera Navigator Data Management Overview | ©2016 Cloudera, Inc. All rights reserved | Cloudera Navigator Frequently Asked Questions >> |
Terms and Conditions Privacy Policy |