Zeppelin Paragraph Status Test

Notes are fundamental elements of a Zeppelin notebook and each instance of Zeppelin has only one notebook which contains many notes. The note can be viewed as a paragraph container. Each note consists of one or more paragraphs of code, which you can use to define and run snippets of code in a flexible manner. Each paragraph consists of 2 sections: code section where you put your source code and result section where you can see the result of the code execution. A paragraph contains code to access services, run jobs, and display results. The user can run all the paragraphs contained in a note sequentially or individual paragraphs can be selected for execution. The status of each paragraph will be shown while executing as READY, FINISHED, ABORT, ERROR, PENDING, and RUNNING. By tracking these status codes, administrator can clearly understand what was exactly happened while executing the paragraphs and can take necessary actions with respect to the respective status. This is where Zeppelin Paragraph Status test helps administrators.

This test continuously tracks the status codes of each paragraph that are executed and reports the number of paragraphs grouped under each status. This test also monitors the total number of paragraphs that are executed on the target Apache Zeppelin. The detailed diagnosis of these measures provides the Paragraph ID, progress, start and finish date of paragraphs grouped under each status.

Target of the test : Apache Zeppelin

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for the target Apache Zeppelin.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed.

Host

The IP address of the target server that is being monitored.

Port

The port number through which the Apache Zeppelin communicates. The default port is 8080.

Username, Password and Confirm Password

To collect metrics from an Apache zeppelin server, the eG agent monitoring the server should be configured to use JMX to connect to the JVM used by the server and pull out the metrics of interest. If JMX requires authentication only (but no security), then ensure that the User Name and Password parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to Monitoring Apache Zeppelin. Confirm the password by retyping it in the Confirm Password text box.

SSL

By default, the SSL flag is set to No, indicating that the target Apache Zeppelin is not SSL-enabled by default. To enable the test to connect to an SSL-enabled Apache Zeppelin, set the SSL flag to Yes.

Timeout

Specify the duration (in seconds) for which this test should wait for a response from the Apache Zeppelin server in the Timeout text box. If there is no response from the server beyond the configured duration, the test will timeout. By default, this is set to 5 seconds.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability.
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Total number of paragraphs

Indicates the total number of paragraphs that are executed during the last measurement period.

Number

 

Ready

Indicates the number of paragraphs that shows the status READY during the last measurement period.

Number

The detailed diagnosis of this measure provides the details such as Paragraph ID, progress, start and finish date of the paragraph.

 

Finished

Indicates the number of paragraphs that shows the status FINISHED during the last measurement period.

 

Aborted

Indicates the number of paragraphs that shows the status ABORT during the last measurement period.

 

Error

Indicates the number of paragraphs that shows the status ERROR during the last measurement period.

 

Pending

Indicates the number of paragraphs that shows the status PENDING during the last measurement period.

 

Running

Indicates the number of paragraphs that shows the status RUNNING during the last measurement period.