Skip to main content




This report works only on Cloudera Distribution of Apache Hadoop (CDH) and Cloudera Data Platform (CDP).

The Forecasting report helps you with capacity planning for your hardware (CPU, Memory) and HDFS by analyzing your historical usage to predict usage trends. This can help you to plan and allocate your disk resources effectively. Each time you create a report, Unravel stores the new data allowing you to generate reports based on a larger pool of data for more accurate forecasting. By default, the last forecasting report is displayed.


All reports, whether scheduled or ad hoc, are archived. Successful reports can be viewed or downloaded from the Reports tab.Reports


Ensure to install GNU Compiler Collection (GCC) version 4.9.3, which consists of compilers and libraries for C, C++, etc., on the Unravel node for the Capacity Forecasting report to function correctly.

In a multi-cluster deployment, install GCC on the Unravel core node.

Also, refer to pre-requisites.

Configuring the Forecasting report


When configuring the Forecasting report on a CDH or CDP cluster, ensure you have one of the following roles.

  • Full Administrator

  • Cluster Administrator

  • Operator

  • Configurator

These roles are required only in the case of Cloudera manager.

  1. Stop Unravel.

    <Unravel installation directory>/unravel/manager stop
  2. Do the following only in the case of a multi-cluster environment:

    1. Run the following command to find the <EDGE_KEY>, which you must provide when configuring the Forecasting report.

      <Unravel installation directory>/unravel/manager config edge show
    2. Select the cluster where the Forecasting report must be enabled. Then, specify each <EDGE_KEY> in the multi-cluster.

      <Unravel installation directory>/unravel/manager config ondemand select-cluster <EDGE_KEY>

      Example: /opt/unravel/manager config ondemand select-cluster local-node

  3. If multiple HDFS entities are configured on the cluster, you must set the com.unraveldata.capacityforecasting.hdfs.entitynames property as follows:

    <Unravel installation directory>/unravel/manager config properties set com.unraveldata.capacityforecasting.hdfs.entitynames <hdfs_entity_name>

    Example: /opt/unravel/manager config properties set com.unraveldata.capacityforecasting.hdfs.entitynames hdfsdevns1

  4. Apply the changes.

    <Unravel installation directory>/unravel/manager config apply
  5. Start Unravel

    <Unravel installation directory>/unravel/manager start
Generating Forecasting report
  1. Click the run.png button to generate a new report. The parameters are:

    • History (Date Range): Choose a date range to analyze the past trend for the forecasting report.

    • Forecasting Specify the number of days for forecasting.

  2. Click Run to generate the report.

    The progress of the report generation is shown at the top of the page. You cannot perform any other tasks when the report is generated.

    A green bar appears when the report is successful and results are displayed. The bar is red upon failure, and the New Report button turns orange.

    In the forecasting report, the graphs display the trend (orange line) from the historical range start-date to the forecast range end-date (x-axis). The trend shows the upper and lower bounds for predicted values. Refer to the trend lines. Your actual physical CPU, memory, and disk capacity determine the y-axis. Click export-format.png to download the graph in a JSON or CSV format. Click BlueExpand.png to expand all the graphs to full width.

    The following capacity forecasting reports are generated:

    • CPU

    • Memory

    • HDFS


    Refer to the following table for the trend lines:



    Vertical dotted line vertical_dotted_line.png

    The vertical dotted line separates the regions of the historical usage/capacity and the predicted usage/capacity.

    Blue line blueline.png

    The blue line shows the total capacity. The total capacity is extrapolated from the last observed capacity.

    Black line blackline.png

    The black line shows the historical usage.

    Orange line orangeline.png

    The orange line shows the historical usage trends and the predicted usages with lower and upper bounds.

Scheduling Capacity Forecasting Report
  1. Click schedule.png to generate the report regularly and provide the following details:

    • History (Date Range): Use the date picker drop-down to specify the date range to analyze the past utilization trend for the forecasting report.

    • Forecasting Specify the number of days for forecasting.

    • Schedule Name: Name of the schedule.

    • Schedule to Run: Select any of the following schedule options from the drop-down and set the time from the hours and minutes drop-down:

      • Daily

      • Selected a day in the week.(Sun, Mon, Tue, Wed, Thu, Fri, Sat)

      • Every two weeks

      • Every month

    • Notification: Provide email IDs to receive the notification of the reports generated.

  2. Click Schedule