Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Sean Owen 948c2390ab SPARK-3357 [CORE] Internal log messages should be set at DEBUG level instead of INFO
Demote some 'noisy' log messages to debug level. I added a few more, to include everything that gets logged in stanzas like this:

```
15/03/01 00:03:54 INFO BlockManager: Removing broadcast 0
15/03/01 00:03:54 INFO BlockManager: Removing block broadcast_0_piece0
15/03/01 00:03:54 INFO MemoryStore: Block broadcast_0_piece0 of size 839 dropped from memory (free 277976091)
15/03/01 00:03:54 INFO BlockManagerInfo: Removed broadcast_0_piece0 on localhost:49524 in memory (size: 839.0 B, free: 265.1 MB)
15/03/01 00:03:54 INFO BlockManagerMaster: Updated info of block broadcast_0_piece0
15/03/01 00:03:54 INFO BlockManager: Removing block broadcast_0
15/03/01 00:03:54 INFO MemoryStore: Block broadcast_0 of size 1088 dropped from memory (free 277977179)
15/03/01 00:03:54 INFO ContextCleaner: Cleaned broadcast 0
```

as well as regular messages like

```
15/03/01 00:02:33 INFO MemoryStore: ensureFreeSpace(2640) called with curMem=47322, maxMem=278019440
```

WDYT? good or should some be left alone?

CC mengxr who suggested some of this.

Author: Sean Owen <sowen@cloudera.com>

Closes #4838 from srowen/SPARK-3357 and squashes the following commits:

dce75c1 [Sean Owen] Back out some debug level changes
d9b784d [Sean Owen] Demote some 'noisy' log messages to debug level
2015-03-02 08:51:03 +00:00
assembly SPARK-5669 [BUILD] [HOTFIX] Spark assembly includes incompatibly licensed libgfortran, libgcc code via JBLAS 2015-02-18 14:41:44 +00:00
bagel [SPARK-4048] Enhance and extend hadoop-provided profile. 2015-01-08 17:15:13 -08:00
bin [SPARK-5765][Examples]Fixed word split problem in run-example and compute-classpath 2015-02-12 14:44:21 -08:00
build SPARK-5856: In Maven build script, launch Zinc with more memory 2015-02-17 10:10:01 -08:00
conf [Spark-5708] Add Slf4jSink to Spark Metrics 2015-02-24 20:50:16 +00:00
core SPARK-3357 [CORE] Internal log messages should be set at DEBUG level instead of INFO 2015-03-02 08:51:03 +00:00
data/mllib [SPARK-5939][MLLib] make FPGrowth example app take parameters 2015-02-23 08:47:28 -08:00
dev [SPARK-5944] [PySpark] fix version in Python API docs 2015-02-25 15:13:34 -08:00
docker [SPARK-1342] Scala 2.10.4 2014-04-01 18:35:50 -07:00
docs [SPARK-6083] [MLLib] [DOC] Make Python API example consistent in NaiveBayes 2015-03-01 16:28:15 -08:00
ec2 [SPARK-5335] Fix deletion of security groups within a VPC 2015-02-12 23:26:24 +00:00
examples [Streaming][Minor]Fix some error docs in streaming examples 2015-03-02 08:49:19 +00:00
external [Streaming][Minor] Remove useless type signature of Java Kafka direct stream API 2015-02-27 13:01:42 -08:00
extras SPARK-4682 [CORE] Consolidate various 'Clock' classes 2015-02-19 15:35:23 -08:00
graphx [SPARK-1955][GraphX]: VertexRDD can incorrectly assume index sharing 2015-02-25 14:11:12 -08:00
mllib [SPARK-6053][MLLIB] support save/load in PySpark's ALS 2015-03-01 16:26:57 -08:00
network [SPARK-6070] [yarn] Remove unneeded classes from shuffle service jar. 2015-02-27 22:44:11 -08:00
project SPARK-4682 [CORE] Consolidate various 'Clock' classes 2015-02-19 15:35:23 -08:00
python [Streaming][Minor]Fix some error docs in streaming examples 2015-03-02 08:49:19 +00:00
repl [SPARK-3340] Deprecate ADD_JARS and ADD_FILES 2015-02-16 18:06:58 -08:00
sbin [Spark-5889] Remove pid file after stopping service. 2015-02-19 23:13:02 +00:00
sbt Adde LICENSE Header to build/mvn, build/sbt and sbt/sbt 2014-12-29 10:48:53 -08:00
sql [SPARK-6074] [sql] Package pyspark sql bindings. 2015-03-01 11:05:10 +00:00
streaming [SPARK-5943][Streaming] Update the test to use new API to reduce the warning 2015-02-23 11:27:27 +00:00
tools SPARK-4159 [CORE] Maven build doesn't run JUnit test suites 2015-01-06 12:02:08 -08:00
yarn [SPARK-6059][Yarn] Add volatile to ApplicationMaster's reporterThread and allocator 2015-02-27 13:33:39 +00:00
.gitattributes [SPARK-3870] EOL character enforcement 2014-10-31 12:39:52 -07:00
.gitignore [SPARK-4501][Core] - Create build/mvn to automatically download maven/zinc/scalac 2014-12-27 13:26:38 -08:00
.rat-excludes [SPARK-5778] throw if nonexistent metrics config file provided 2015-02-17 10:57:16 -08:00
CONTRIBUTING.md [Docs] minor grammar fix 2014-09-17 12:33:09 -07:00
LICENSE SPARK-5984: Fix TimSort bug causes ArrayOutOfBoundsException 2015-02-28 18:55:34 -08:00
make-distribution.sh SPARK-5747: Fix wordsplitting bugs in make-distribution.sh 2015-02-12 14:52:38 -08:00
NOTICE SPARK-1827. LICENSE and NOTICE files need a refresh to contain transitive dependency info 2014-05-14 09:38:33 -07:00
pom.xml SPARK-5357: Update commons-codec version to 1.10 (current) 2015-02-16 23:05:34 +00:00
README.md [Docs] Fix Building Spark link text 2015-02-02 12:33:49 -08:00
scalastyle-config.xml [Core] Upgrading ScalaStyle version to 0.5 and removing SparkSpaceAfterCommentStartChecker. 2014-10-16 02:05:44 -04:00
tox.ini [SPARK-3073] [PySpark] use external sort in sortBy() and sortByKey() 2014-08-26 16:57:40 -07:00

Apache Spark

Spark is a fast and general cluster computing system for Big Data. It provides high-level APIs in Scala, Java, and Python, and an optimized engine that supports general computation graphs for data analysis. It also supports a rich set of higher-level tools including Spark SQL for SQL and structured data processing, MLlib for machine learning, GraphX for graph processing, and Spark Streaming for stream processing.

http://spark.apache.org/

Online Documentation

You can find the latest Spark documentation, including a programming guide, on the project web page and project wiki. This README file only contains basic setup instructions.

Building Spark

Spark is built using Apache Maven. To build Spark and its example programs, run:

mvn -DskipTests clean package

(You do not need to do this if you downloaded a pre-built package.) More detailed documentation is available from the project site, at "Building Spark".

Interactive Scala Shell

The easiest way to start using Spark is through the Scala shell:

./bin/spark-shell

Try the following command, which should return 1000:

scala> sc.parallelize(1 to 1000).count()

Interactive Python Shell

Alternatively, if you prefer Python, you can use the Python shell:

./bin/pyspark

And run the following command, which should also return 1000:

>>> sc.parallelize(range(1000)).count()

Example Programs

Spark also comes with several sample programs in the examples directory. To run one of them, use ./bin/run-example <class> [params]. For example:

./bin/run-example SparkPi

will run the Pi example locally.

You can set the MASTER environment variable when running examples to submit examples to a cluster. This can be a mesos:// or spark:// URL, "yarn-cluster" or "yarn-client" to run on YARN, and "local" to run locally with one thread, or "local[N]" to run locally with N threads. You can also use an abbreviated class name if the class is in the examples package. For instance:

MASTER=spark://host:7077 ./bin/run-example SparkPi

Many of the example programs print usage help if no params are given.

Running Tests

Testing first requires building Spark. Once Spark is built, tests can be run using:

./dev/run-tests

Please see the guidance on how to run all automated tests.

A Note About Hadoop Versions

Spark uses the Hadoop core library to talk to HDFS and other Hadoop-supported storage systems. Because the protocols have changed in different versions of Hadoop, you must build Spark against the same version that your cluster runs.

Please refer to the build documentation at "Specifying the Hadoop Version" for detailed guidance on building for a particular distribution of Hadoop, including building for particular Hive and Hive Thriftserver distributions. See also "Third Party Hadoop Distributions" for guidance on building a Spark application that works with a particular distribution.

Configuration

Please refer to the Configuration guide in the online documentation for an overview on how to configure Spark.