Troubleshoot Apache Spark by using Azure HDInsight

Learn about the top issues and their resolutions when working with Apache Spark payloads in Apache Ambari.

How do I configure an Apache Spark application by using Apache Ambari on clusters?

Spark configuration values can be tuned help avoid an Apache Spark application OutofMemoryError exception. The following steps show default Spark configuration values in Azure HDInsight:

  1. Log in to Ambari at https://CLUSTERNAME.azurehdidnsight.net with your cluster credentials. The initial screen displays an overview dashboard. There are slight cosmetic differences between HDInsight 3.6 and 4.0.

  2. Navigate to Spark2 > Configs.

    Select the Configs tab

  3. In the list of configurations, select and expand Custom-spark2-defaults.

  4. Look for the value setting that you need to adjust, such as spark.executor.memory. In this case, the value of 9728m is too high.

    Select custom-spark-defaults

  5. Set the value to the recommended setting. The value 2048m is recommended for this setting.

  6. Save the value, and then save the configuration. Select Save.

    Change value to 2048m

    Write a note about the configuration changes, and then select Save.

    Enter a note about the changes you made

    You are notified if any configurations need attention. Note the items, and then select Proceed Anyway.

    Select Proceed Anyway

  7. Whenever a configuration is saved, you are prompted to restart the service. Select Restart.

    Select restart

    Confirm the restart.

    Select Confirm Restart All

    You can review the processes that are running.

    Review running processes

  8. You can add configurations. In the list of configurations, select Custom-spark2-defaults, and then select Add Property.

    Select add property

  9. Define a new property. You can define a single property by using a dialog box for specific settings such as the data type. Or, you can define multiple properties by using one definition per line.

    In this example, the spark.driver.memory property is defined with a value of 4g.

    Define new property

  10. Save the configuration, and then restart the service as described in steps 6 and 7.

These changes are cluster-wide but can be overridden when you submit the Spark job.

How do I configure an Apache Spark application by using a Jupyter Notebook on clusters?

In the first cell of the Jupyter Notebook, after the %%configure directive, specify the Spark configurations in valid JSON format. Change the actual values as necessary:

Add a configuration

How do I configure an Apache Spark application by using Apache Livy on clusters?

Submit the Spark application to Livy by using a REST client like cURL. Use a command similar to the following. Change the actual values as necessary:

curl -k --user 'username:password' -v -H 'Content-Type: application/json' -X POST -d '{ "file":"wasb://container@storageaccountname.blob.core.windows.net/example/jars/sparkapplication.jar", "className":"com.microsoft.spark.application", "numExecutors":4, "executorMemory":"4g", "executorCores":2, "driverMemory":"8g", "driverCores":4}'  

How do I configure an Apache Spark application by using spark-submit on clusters?

Launch spark-shell by using a command similar to the following. Change the actual value of the configurations as necessary:

spark-submit --master yarn-cluster --class com.microsoft.spark.application --num-executors 4 --executor-memory 4g --executor-cores 2 --driver-memory 8g --driver-cores 4 /home/user/spark/sparkapplication.jar

Additional reading

Apache Spark job submission on HDInsight clusters

Next steps

If you didn't see your problem or are unable to solve your issue, visit one of the following channels for more support: