[
https://issues.apache.org/jira/browse/STORM-1393?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15062784#comment-15062784
]
ASF GitHub Bot commented on STORM-1393:
---------------------------------------
Github user d2r commented on a diff in the pull request:
https://github.com/apache/storm/pull/949#discussion_r47959489
--- Diff: docs/documentation/Logs.md ---
@@ -0,0 +1,30 @@
+---
+title: Storm Logs
+layout: documentation
+documentation: true
+---
+Logs in Storm are essential for tracking the status, operations, error
messages and debug information for all the
+daemons (nimbus, supervisor, logviewer, drpc, ui) and topologies' workers.
+
+### Location of the Logs
+All the daemon logs are placed under ${storm.log.dir} directory, which a
user can set in the System properties or
+in the cluster configuration. By default, ${storm.log.dir} points to
${storm.home}/logs.
+
+All the worker logs are placed under the workers-artifacts directory in a
hierarchical manner, e.g.,
+${workers-artifacts}/${topologyId}/${port}/worker.log. Users can set the
workers-artifacts directory
+by configuring the variable "storm.workers.artifacts.dir". By default,
workers-artifacts directory
+locates at ${storm.log.dir}/logs/workers-artifacts.
+
+### Using the Storm UI for Log View/Download and Log Search
+Daemon and worker logs are allowed to view and download through Storm UI
by authorized users.
+
+To improve the debugging of Storm, we provide the Log Search feature.
+Log Search supports searching in a certain log file or in a topology's all
log files:
--- End diff --
`or in all of a topology's log files`
> Sort out storm.log.dir configure and add documentation about logs
> -----------------------------------------------------------------
>
> Key: STORM-1393
> URL: https://issues.apache.org/jira/browse/STORM-1393
> Project: Apache Storm
> Issue Type: Improvement
> Components: storm-core
> Affects Versions: 0.11.0
> Reporter: Zhuo Liu
> Assignee: Zhuo Liu
> Priority: Minor
> Fix For: 0.11.0
>
>
> Currently, we have reorganized logs in STORM-901 and STORM-1387, it is
> preferable for us to document the changes out for avoiding confusion to
> users.
> Also, the util/LOG-DIR and the way supervisor to get storm.log.dir in
> worker-launch is inaccurate since it does not take the storm-conf into
> account. We should fix it.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
