Junos Space. Reports. Release Published: Copyright 2014, Juniper Networks, Inc.

Transcription

1 Junos Space Reports Release 14.1 Published:

2 Juniper Networks, Inc North Mathilda Avenue Sunnyvale, California USA All rights reserved. Juniper Networks, Junos, Steel-Belted Radius, NetScreen, and ScreenOS are registered trademarks of Juniper Networks, Inc. in the United States and other countries. The Juniper Networks Logo, the Junos logo, and JunosE are trademarks of Juniper Networks, Inc. All other trademarks, service marks, registered trademarks, or registered service marks are the property of their respective owners. Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or otherwise revise this publication without notice. Junos Space Reports 14.1 All rights reserved. The information in this document is current as of the date on the title page. YEAR 2000 NOTICE Juniper Networks hardware and software products are Year 2000 compliant. Junos OS has no known time-related limitations through the year However, the NTP application is known to have some difficulty in the year END USER LICENSE AGREEMENT The Juniper Networks product that is the subject of this technical documentation consists of (or is intended for use with) Juniper Networks software. Use of such software is subject to the terms and conditions of the End User License Agreement ( EULA ) posted at By downloading, installing or using such software, you agree to the terms and conditions of that EULA. ii

3 Table of Contents About the Documentation vii Documentation and Release Notes vii Documentation Conventions vii Documentation Feedback ix Requesting Technical Support x Self-Help Online Tools and Resources x Opening a Case with JTAC x Part 1 Overview Chapter 1 Reports Reports Overview Part 2 Configuration Chapter 2 Report Definitions Creating Report Definitions Part 3 Administration Chapter 3 Report Definitions Viewing Report Definitions Cloning Report Definitions Deleting Report Definitions Modifying Report Definitions Chapter 4 Reports Generating Reports Viewing Generated Reports Deleting Generated Reports Part 4 Index Index iii

4 Reports iv

5 List of Tables About the Documentation vii Table 1: Notice Icons viii Table 2: Text and Syntax Conventions viii Part 1 Overview Chapter 1 Reports Table 3: Audit Trail Report Definition Attributes Table 4: Device Inventory Report Definition Attributes Table 5: Device License Inventory Report Definition Attributes Table 6: Device Logical Interface Inventory Report Definition Attributes Table 7: Device Physical Interface Inventory Report Definition Attributes Table 8: Device Physical Inventory Report Definition Attributes Table 9: Device Software Inventory Report Definition Attributes Table 10: Job Inventory Report Definition Attributes Table 11: User Account Report Definition Attributes v

6 Reports vi

7 About the Documentation Documentation and Release Notes Documentation and Release Notes on page vii Documentation Conventions on page vii Documentation Feedback on page ix Requesting Technical Support on page x Documentation Conventions To obtain the most current version of all Juniper Networks technical documentation, see the product documentation page on the Juniper Networks website at If the information in the latest release notes differs from the information in the documentation, follow the product Release Notes. Juniper Networks Books publishes books by Juniper Networks engineers and subject matter experts. These books go beyond the technical documentation to explore the nuances of network architecture, deployment, and administration. The current list can be viewed at Table 1 on page viii defines notice icons used in this guide. vii

8 Reports Table 1: Notice Icons Icon Meaning Description Informational note Indicates important features or instructions. Caution Indicates a situation that might result in loss of data or hardware damage. Warning Alerts you to the risk of personal injury or death. Laser warning Alerts you to the risk of personal injury from a laser. Tip Indicates helpful information. Best practice Alerts you to a recommended use or implementation. Table 2: Text and Syntax Conventions Table 2 on page viii defines the text and syntax conventions used in this guide. Convention Description Examples Bold text like this Represents text that you type. To enter configuration mode, type the configure command: user@host> configure Fixed-width text like this Italic text like this Represents output that appears on the terminal screen. Introduces or emphasizes important new terms. Identifies guide names. Identifies RFC and Internet draft titles. user@host> show chassis alarms No alarms currently active A policy term is a named structure that defines match conditions and actions. Junos OS CLI User Guide RFC 1997, BGP Communities Attribute Italic text like this Represents variables (options for which you substitute a value) in commands or configuration statements. Configure the machine s domain name: [edit] root@# set system domain-name domain-name viii

9 About the Documentation Table 2: Text and Syntax Conventions (continued) Convention Description Examples Text like this Represents names of configuration statements, commands, files, and directories; configuration hierarchy levels; or labels on routing platform components. To configure a stub area, include the stub statement at the [edit protocols ospf area area-id] hierarchy level. The console port is labeled CONSOLE. < > (angle brackets) Encloses optional keywords or variables. stub <default-metric metric>; (pipe symbol) Indicates a choice between the mutually exclusive keywords or variables on either side of the symbol. The set of choices is often enclosed in parentheses for clarity. broadcast multicast (string1 string2 string3) # (pound sign) Indicates a comment specified on the same line as the configuration statement to which it applies. rsvp { # Required for dynamic MPLS only [ ] (square brackets) Encloses a variable for which you can substitute one or more values. community name members [ community-ids ] Indention and braces ( { } ) ; (semicolon) Identifies a level in the configuration hierarchy. Identifies a leaf statement at a configuration hierarchy level. [edit] routing-options { static { route default { nexthop address; retain; } } } GUI Conventions Bold text like this Represents graphical user interface (GUI) items you click or select. In the Logical Interfaces box, select All Interfaces. To cancel the configuration, click Cancel. > (bold right angle bracket) Separates levels in a hierarchy of menu selections. In the configuration editor hierarchy, select Protocols>Ospf. Documentation Feedback We encourage you to provide feedback, comments, and suggestions so that we can improve the documentation. You can provide feedback by using either of the following methods: Online feedback rating system On any page at the Juniper Networks Technical Documentation site at simply click the stars to rate the content, and use the pop-up form to provide us with information about your experience. Alternately, you can use the online feedback form at ix

10 Reports Send your comments to Include the document or topic name, URL or page number, and software version (if applicable). Requesting Technical Support Technical product support is available through the Juniper Networks Technical Assistance Center (JTAC). If you are a customer with an active J-Care or JNASC support contract, or are covered under warranty, and need post-sales technical support, you can access our tools and resources online or open a case with JTAC. JTAC policies For a complete understanding of our JTAC procedures and policies, review the JTAC User Guide located at Product warranties For product warranty information, visit JTAC hours of operation The JTAC centers have resources available 24 hours a day, 7 days a week, 365 days a year. Self-Help Online Tools and Resources For quick and easy problem resolution, Juniper Networks has designed an online self-service portal called the Customer Support Center (CSC) that provides you with the following features: Find CSC offerings: Search for known bugs: Find product documentation: Find solutions and answer questions using our Knowledge Base: Download the latest versions of software and review release notes: Search technical bulletins for relevant hardware and software notifications: Join and participate in the Juniper Networks Community Forum: Open a case online in the CSC Case Management tool: To verify service entitlement by product serial number, use our Serial Number Entitlement (SNE) Tool: Opening a Case with JTAC You can open a case with JTAC on the Web or by telephone. Use the Case Management tool in the CSC at Call JTAC ( toll-free in the USA, Canada, and Mexico). x

11 About the Documentation For international or direct-dial options in countries without toll-free numbers, see xi

12 Reports xii

13 PART 1 Overview Reports on page 3 1

14 Reports 2

15 CHAPTER 1 Reports Reports Overview on page 3 Reports Overview You can use the Reports workspace to generate customized reports for managing the resources on your network. You can use these reports to gather data related to the device inventory details, job execution details, and audit trails. You first create a report definition to specify what information to retrieve from the Junos Space Network Management Platform inventory database. You then use this report definition to generate, export, and print the reports. Junos Space Network Management Platform provides some predefined categories to create report definitions. You can combine multiple categories to create a report definition. By default, a predefined set of attributes are included in a report definition. You can choose to add or remove the attributes according to what information you want from the final generated report. You can group, sort, or filter data based on specific attributes available with the report definition. You can use the following predefined categories to create report definitions: 3

16 Reports Audit Trail report definition This report definition allows you to view the audit log activities and tasks initiated on Junos Space Platform. Table 3 on page 4 lists the attributes available with this report definition. Table 3: Audit Trail Report Definition Attributes Attribute Description User Name Login ID of the user who initiated the task User IP IP address of the client computer that the user used to initiate the task Task Name of the task that triggered the audit log Timestamp Time in the UTC time format in the database that is mapped to the local timezone of client computer Result Execution result of the task that triggered the audit log Job ID Job ID of the job-based task that is included in the audit log Description Description of the audit log logged on Junos Space Network Management Platform Device Inventory report definition This report definition allows you to view the generic characteristics of all devices managed by Junos Space Network Management Platform. Table 4 on page 4 lists the attributes available with this report definition. Table 4: Device Inventory Report Definition Attributes Attribute Description Name Name of the device Configuration State State of the configuration on a device Vendor Vendor of the device IP Address IP address of the device Managed Status Current status of the managed device in Junos Space Network Management Platform Device Family Device family of the selected device OS Version Operating system firmware version running on the device Platform Model number of the device Serial Number Serial number of the device chassis Connection Status Connection status of the device whether UP or DOWN 4

17 Chapter 1: Reports Table 4: Device Inventory Report Definition Attributes (continued) Attribute Description Schema Version Junos OS configuration schema version on the device Authentication Status Mode of connecting the device to Junos Space Network Management Platform whether key-based, credentials-based, or a key conflict Serial Number Serial number of the device Connection Type Type of connection between the device and Junos Space Network Management Platform Device License Inventory report definition This report definition allows you to view the generic characteristics of device license information for devices managed by Junos Space Network Management Platform. Table 5 on page 5 lists the attributes available with this report definition. Table 5: Device License Inventory Report Definition Attributes Attribute Description Device Name Name of the device Feature Name Name of the licensed SKU or feature License Count Number of times an item has been licensed Used Count Number of times the feature is used Need Count Number of times the feature is used without a license Given Number of instances of the feature that are provided by default OS Version Operating system firmware version running on the device Device Family Device family of the selected device Platform Model number of the device Serial Number Serial number of the device Device Logical Interface Inventory report definition This report definition allows you to view the generic characteristics of the logical interface for devices managed by Junos Space Network Management Platform. Table 6 on page 6 lists the attributes available with this report definition. 5

18 Reports Table 6: Device Logical Interface Inventory Report Definition Attributes Attribute Description Device Name Name of the device Physical Interface Name of the physical interface Admin Status Admin status of the interface whether UP or DOWN. Link Type Type of the physical interface link whether full duplex or half duplex Logical Interface Name of the logical interface Logical Interface IP IP address of the logical interface Logical Encapsulation Encapsulation used on the logical interface VLAN VLAN ID of the logical interface OS Version Operating system firmware version running on the device Device Family Device family of the selected device Platform Model number of the device Serial Number Serial number of the device chassis Device IP Address IP address of the device Physical Interface IP IP address of the physical interface MAC Address MAC address of the physical interface Operation Status Operational status of the interface whether UP or DOWN Physical Encapsulation Encapsulation used on the physical interface Speed Speed at which the interface is running (in Mbps) MTU Size of the MTU. Description Description of the logical interface Device Physical Interface Inventory report definition This report definition allows you to view the generic characteristics of the logical interface for devices managed by Junos Space Network Management Platform. Table 7 on page 7 lists the attributes available with this report definition. 6

19 Chapter 1: Reports Table 7: Device Physical Interface Inventory Report Definition Attributes Attribute Description Device Name Name of the device Physical Interface Name of the physical interface Admin Status Admin status of the interface UP or DOWN Link Type Type of the physical interface link full duplex or half duplex Link Level Type type of the link level IP Address IP address of the physical interface OS Version Operating system firmware version running on the device Device Family Device family of the selected device Platform Model number of the device Serial Number Serial number of the device chassis MAC Address MAC address of the physical interface Operation Status Operational status of the interface, whether UP or DOWN Encapsulation Encapsulation used on the physical interface Speed Speed at which the interface is running (in Mbps) MTU Size of the MTU Description Description of the physical interface Device Physical Inventory report definition Use this report definition to view the generic characteristics of the hardware modules for devices managed by Junos Space Network Management Platform. Table 8 on page 7 lists the attributes available with this report definition. Table 8: Device Physical Inventory Report Definition Attributes Attribute Description Device Name Name of the device Chassis Chassis component of the device Module Components contained in the chassis 7

20 Reports Table 8: Device Physical Inventory Report Definition Attributes (continued) Attribute Description Sub Module Components contained in the submodule Sub Sub Module Components contained in the submodule of the submodule Sub Sub Sub Module Components contained in the submodule of the submodule of the submodule Model Model name of the component Model Number Model number of the device component Part Number Part number of the chassis component. Revision Revision number of the component Part Serial Number Hardware serial number of the component Status Current operation status of the component IP Address IP address of the physical component Device Family Device family of the selected device Platform Model number of the device Serial Number Serial number of the device chassis Description Description of the physical component NOTE: You can filter the columns in device physical inventory report by using only tags. You can also sort and group the Device Name column only in the device physical inventory report. Device Software Inventory report definition This report definition allows you to view the generic software package installation information for devices managed by Junos Space Network Management Platform. Table 9 on page 8 lists the attributes available with this report definition. Table 9: Device Software Inventory Report Definition Attributes Attribute Description Device Name Device configuration name for the device Package Name Name of the software package installed on the device 8

21 Chapter 1: Reports Table 9: Device Software Inventory Report Definition Attributes (continued) Attribute Description Version Version number of the software package installed on the device Type Type of the software package installed on the device OS Version Operating system firmware version running on the device Device Family Device family of the selected device Platform Model number of the device Serial Number Serial number of the device chassis Model Model of the device Routing Engine Specific Routing Engine on a device supporting multiple Routing Engines Description Description of the installed software package Job Inventory report definition This report definition allows you to view the generic execution characteristics of Junos Space Network Management Platform Jobs. Table 10 on page 9 lists the attributes available with this report definition. Table 10: Job Inventory Report Definition Attributes Attribute Description ID Numerical ID of the job Name Name of the job appended with the job ID Percent Percentage completion of the job Job Type Supported job types State State of job execution Summary Operations executed for the job Scheduled Start Time Start time specified for the job User Login name of the user who scheduled the job Recurrence Recurrence of the job Retry Group ID Job ID of the retry job Actual Start Time Time when the job started to execute 9

22 Reports Table 10: Job Inventory Report Definition Attributes (continued) Attribute Description End Time Time the job ended Previous Retry Job ID of the previous retry job User Account report definition This report definition allows you to view details of user accounts in Junos Space Platform. Table 11 on page 10 lists the attributes available with this report definition. Table 11: User Account Report Definition Attributes Attribute Description User Name Username of the user First Name First name of the user Last Name Last name of the user address of the user User Type Type of user: local or remote Status Status of the user Password Status Status of the password GUI/API Access Type of access: GUI or API Locked Out Whether the user is locked out Roles Roles to which the user is assigned Domains Domains to which the user is assigned When you add filter criteria for a column in a report definition, you can enter multiple filter values. You can separate filter values using commas. Columns that meet any of the filter values are listed in the report. The data types that support filtering using multiple filter values are String, Integer, Date, and Enum. You can use the report definitions to generate reports in CSV, HTML, and PDF formats. The reports display the name of the report and the description of the report. You can schedule the delivery of generated reports to a designated SMTP server or a SCP server. You can view, download, or print the generated reports from the Generated Reports page in the Reports workspace. You can also tag the reports and report definitions (See Tagging an Object). 10

23 Chapter 1: Reports Related Documentation Creating Report Definitions on page 15 Generating Reports on page 23 11

24 Reports 12

25 PART 2 Configuration Report Definitions on page 15 13

26 Reports 14

27 CHAPTER 2 Report Definitions Creating Report Definitions Creating Report Definitions on page 15 Report definitions specify what information to retrieve from the Junos Space Network Management Platform inventory database and how this information is displayed in the reports generated using the report definition. You can create report definitions from the Reports workspace. The Report Definitions page in the Reports workspace lists all the report definitions you have created. It also lists the name of the report definition, the user who created the report definition, the time the report definition was created, and the description of the report definition. To create a report definition: 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Click the Create Report Definition icon from the Actions bar. The Create Report Definition page is displayed. 3. In the Report Name field, type a user-defined report definition name. A report definition name cannot exceed 128 characters and can contain only letters, numbers, spaces, and some special characters. The special characters allowed are hyphen (-), underscore (_), period (.), at (@), single quote ( ), forward slash (/), and ampersand (&). 4. (Optional) In the Description field, type a user-defined description. The description cannot exceed 256 characters. 5. Click the Add icon below the Description field. The Select Categories window is displayed. 6. Select the check boxes next to the categories you want to add to the report definition. 7. Click Add. 8. Click the Pencil icon in the Filter column corresponding to the category in which you want to add the column and filter. 15

28 Reports The Edit Columns/Filters window is displayed. 9. Select the columns that you want to add to the report definition from the Available column and click the right arrow to move the filters to the Selected column. 10. Select an appropriate option in the Group By drop-down list to group the columns in the report definition in a specific order. 11. Select an appropriate option in the Sort By drop-down list to sort the columns in the report definition in a specific order. 12. Select the appropriate option button next to the Sorting Order section to choose a order of sorting the columns in the report definition. 13. Click the Add Filter icon next to add filters in the report definition. 14. Select the appropriate column from the drop-down list for which you want to add a filter. 15. Select the appropriate operand corresponding to the column, from the drop-down list. 16. Type the criteria to be filtered. 17. Click OK. 18. Click Create. You can use the report definition to generate reports. (See Generating Reports on page 23). NOTE: You can view the reports generated from a report definition by clicking the View link in the Reports column corresponding to the report definition. Related Documentation Reports Overview on page 3 Modifying Report Definitions on page 21 16

29 PART 3 Administration Report Definitions on page 19 Reports on page 23 17

30 Reports 18

31 CHAPTER 3 Report Definitions Viewing Report Definitions Viewing Report Definitions on page 19 Cloning Report Definitions on page 19 Deleting Report Definitions on page 20 Modifying Report Definitions on page 21 You can view the report definitions from the Report Definitions page. The Report Definitions page lists the name of the report definition, the user who created the report definition, the time the report definition was created, and the description of the report definition. To view the details of a report definition: 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Select the report definition whose details you want to view and click the View Report Definition icon on the Actions bar. The View Report Definition window is displayed. You can view the report definition categories you have selected for this report definition, the columns selected in the report definition categories, and the filter criteria you specified. 3. Click OK to close the window. Related Documentation Reports Overview on page 3 Creating Report Definitions on page 15 Cloning Report Definitions You can clone the report definitions from the Report Definitions page. The Report Definitions page lists the name of the report definition, the user who created the report definition, the time the report definition was created, and the description of the report definition. To clone a report definition: 19

32 Reports 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Select the report definition you want to clone and select Clone Report Definition from the contextual Actions menu. The Clone Report Definition page is displayed. 3. In the Report Name field, type a user-defined report definition name. A report definition name cannot exceed 128 characters and can contain only letters, numbers, spaces, and some special characters. The special characters allowed are hyphen (-), underscore (_), period (.), at (@), single quote ( ), forward slash (/), and ampersand (&). 4. (Optional) In the Description field, type a user-defined description. The description cannot exceed 256 characters. 5. (Optional) Modify the report definition categories and the respective filters. 6. Click Clone. Related Documentation Reports Overview on page 3 Creating Report Definitions on page 15 Deleting Report Definitions You can delete the report definitions from the Report Definitions page. The Report Definitions page lists the name of the report definition, the user who created the report definition, the time the report definition was created, and the description of the report definition. To delete a report definition: 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Select the report definitions you want to delete and click the Delete Report Definition icon from the Actions bar. The Delete Report Definition window is displayed. 3. Click Delete. Related Documentation Reports Overview on page 3 Creating Report Definitions on page 15 20

33 Chapter 3: Report Definitions Modifying Report Definitions You can modify the report definitions from the Report Definitions page. The Report Definitions page lists the name of the report definition, the user who created the report definition, the time the report definition was created, and the description of the report definition. To modify a report definition: 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Select the report definition you want to modify and select the Modify Report Definition icon from the Actions bar. The Modify Report Definition page is displayed. You can change all the parameters of the report definition except the name of the report definition. 3. Modify the necessary fields and click Modify. Related Documentation Reports Overview on page 3 Creating Report Definitions on page 15 21

34 Reports 22

35 CHAPTER 4 Reports Generating Reports on page 23 Viewing Generated Reports on page 24 Deleting Generated Reports on page 25 Generating Reports You can generate reports from the report definitions you have created. The types of reports provided by Junos Space Network Management Platform are Audit Trail report, Device Inventory report, Device Physical Interface Inventory report, Device Logical Interface Inventory report, Device Licence Inventory report, Device Software Inventory report, and Job Inventory report. To generate reports: 1. On the Junos Space Network Management Platform user interface, select Reports > Report Definitions. 2. Right-click the report definition that you want to use to create a report and select the Generate Report icon from the Actions bar. The Generate Reports window is displayed. 3. Select the appropriate report formats you want to generate by selecting the checkboxes next to the Report Format field. Junos Space Network Management Platform provides reports in the CSV, HTML, fpdfand PDF formats. 4. Select the checkbox next to the SCP Server label to configure Junos Space Network Management Platform to store the report in a directory on an SCP server. 5. To configure the SCP server: a. In the IP Address field, enter the IP address of the SCP server. b. From the Port drop-down list, select the appropriate port number. c. In the Directory field, enter the directory on the SCP server where the reports are stored. 23

36 Reports d. In the User Name field, enter the username used to access the SCP server. e. In the Password field, enter the password used to access the SCP server. 6. Select the checkbox next to the SMTP Server label to configure Junos Space Network Management Platform to the report to the addresses you specify. 7. In the Address field, enter the address. 8. Click Add. You can add multiple addresses if you want the report to be delivered to multiple addresses. 9. Click the Schedule at a later time checkbox and schedule the date and time to generate the report automatically. 10. Click the Recurrence checkbox and specify the frequency to generate the report periodically. 11. Click Generate. You can view, download, or print the reports. (See Viewing Generated Reports on page 24). Related Documentation Reports Overview on page 3 Creating Report Definitions on page 15 Viewing Generated Reports You can view the reports you have generated on the Generated Reports page in the Reports workspace. You can view the name of the report, the description of the report, the name of the report definition, user who generated the report, the time the report was generated, the formats in which the report is available, the link to view and download the report, and the job ID for the report generated. To view the reports you have generated: 1. On the Junos Space Network Management Platform user interface, select Reports > Generated Reports. The list of generated reports are displayed in the tabular format. 2. Click the View/Download link corresponding to the report you want to view or download. 3. Click the format of the report you want to view and download. Related Documentation Reports Overview on page 3 Generating Reports on page 23 24

37 Chapter 4: Reports Deleting Generated Reports You can delete the reports you have generated from the Generated Reports page. To delete the reports you have generated: 1. On the Junos Space Network Management Platform user interface, select Reports > Generated Reports. The list of generated reports are displayed in the tabular format. 2. Select the reports you want to delete and click the Delete Generated Report icon on the Actions bar. The Delete Report window is displayed. 3. Click Delete. Related Documentation Reports Overview on page 3 Generating Reports on page 23 25

38 Reports 26

39 PART 4 Index Index on page 29 27

40 Reports 28

41 Index Symbols #, comments in configuration statements...ix ( ), in syntax descriptions...ix < >, in syntax descriptions...ix [ ], in configuration statements...ix { }, in configuration statements...ix (pipe), in syntax descriptions...ix reports modifying...21 viewing...19 deleting...25 generating...23 overview...3 viewing...24 S support, technical See technical support syntax conventions...viii T technical support contacting JTAC...x B braces, in configuration statements...ix brackets angle, in syntax descriptions...ix square, in configuration statements...ix C comments, in configuration statements...ix conventions text and syntax...viii curly braces, in configuration statements...ix customer support...x contacting JTAC...x D documentation comments on...ix F font conventions...viii M manuals comments on...ix P parentheses, in syntax descriptions...ix R report definition cloning...19 creating...15 deleting

42 Reports 30