[
https://issues.apache.org/jira/browse/STORM-1393?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15062788#comment-15062788
]
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_r47959666
--- 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:
+
+String search in a log file: In the log page for a worker, a user can
search a certain string, e.g., "Exception", in for a certain worker log. This
search can happen for both normal text log or rolled ziplog files. In the
results, the offset and matched lines will be displayed.
+
+
+
+Search in a topology: a user can also search a string for a certain
topology by clicking the icon of magnifying lens at the top right corner of the
UI page. This means the UI will try to search on all the supervisor nodes in a
distributed way to find the matched string in all logs for this topology. The
search can happen for both normal text log or rolled zip log files by
checking/unchecking the "Search archived logs:" box. Then the matched results
can be shown on the UI with url links, directing the user to the certain logs
on each supervisor node. This powerful feature is very helpful for users to
find certain problematic supervisor nodes running this topology.
+
+
--- End diff --
`Search`
> 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)
