{"action":"created","comment":{"url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/comments/193858893","pull_request_review_id":126918850,"id":193858893,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDE5Mzg1ODg5Mw==","diff_hunk":"@@ -0,0 +1,45 @@\n+---\r\n+layout: docs\r\n+title:  Troubleshooting IBM Streams Runner for Apache Beam\r\n+navtitle: Troubleshooting\r\n+description: You can troubleshoot any issues that occur when you launch, run, or monitor IBM® Streams Runner for Apache Beam applications.\r\n+weight:  10\r\n+published: true\r\n+tag: beam-120\r\n+prev:\r\n+  file: performance\r\n+  title: Performance considerations\r\n+next:\r\n+  file: issues\r\n+  title: Limitations and known issues\r\n+---\r\n+\r\n+You can troubleshoot any issues that occur when you launch, run, or monitor IBM® Streams Runner for Apache Beam applications. Streams Runner includes several pipeline parameters and componentized options to print more information and help narrow the scope to a specific component. \r\n+\r\n+## Ensure you have the latest fixes\r\n+The latest Streams Runner version is 1.2.0. You can [download](../../../beamrunner-2b-sas/#creating-a-streaming-analytics-service-on-ibm-cloud) the latest Streams Runner installation archive from an IBM Streaming Analytics container-based service. \r\n+\r\n+## Check known problems and solutions\r\n+See if your problem matches any issues in the [issues and limitations page](../issues.md).\r\n+\r\n+## Enable tracing\r\n+Tracing can give information about the translation and execution of your Beam application and can help debug problems.\r\n+\r\n+### Trace levels\r\n+Streams Runner tracing levels follow SLF4J's levels of `ERROR`, `WARN`, `INFO`, `DEBUG`, and `TRACE` with increasing verbosity and information.\r\n+\r\n+### Translation-time\r\n+Streams Runner uses Beam utilities and the [streamsx.topology](http://ibmstreams.github.io/streamsx.topology/) toolkit to translate your Beam application into a Streams application, submit the application to your IBM Streams instance or IBM Streaming Analytics service, and provide connections to the instance or service for monitoring or cancellation. Log messages about these activites are printed to the console where the Beam program is executed. When specifying the program command, you can use the `--traceTranslation` pipeline option to specify a trace level for the runner, topology toolkit, and/or global scopes. For example, a\r\n+user can debug a SAB compilation (done by the topology toolkit) without verbose Beam or Streams Runner translation logging by specifying `--traceTranslation=INFO,Streams=DEBUG`.\r\n+\r\n+By default, Streams Runner uses `INFO` level tracing when translating so users can view helpful messages about their application preparation and submission while the topology toolkit and Beam loggers are set to `WARN`. To set the runner, topology, or global (for Beam and its dependencies) trace levels, see the description of `traceTranslation` in [Streams Runner pipeline options](../reference/#streams-runner-pipeline-options).\r\n+\r\n+### Runtime\r\n+When your application is successfully submitted and started on a Streams environment, the application will use the tracing levels set by the `--traceRuntime` and log all messages including standard output and error to log files on the distributed environment. The application trace level can be changed after the job is running from Streams Console for individual operators (transforms), processing elements (PEs), or the entire job. For more information about viewing, downloading application logs, or changing trace levels from Streams Console, see the [Troubleshooting section of the Streaming Analytics Development Guide](https://developer.ibm.com/streamsdev/docs/bluemix-streaming-analytics-development-guide/#troubleshooting).\r","path":"docs/beamrunner/release/1.2.0/troubleshoot.md","position":37,"original_position":38,"commit_id":"236f0f06384a25c2459e450857bec1f075bd39f2","original_commit_id":"fc5d344e85693c8ff9f530b9adec80bf6d3fa827","user":{"login":"pamlane","id":25987785,"node_id":"MDQ6VXNlcjI1OTg3Nzg1","avatar_url":"https://avatars1.githubusercontent.com/u/25987785?v=4","gravatar_id":"","url":"https://api.github.com/users/pamlane","html_url":"https://github.com/pamlane","followers_url":"https://api.github.com/users/pamlane/followers","following_url":"https://api.github.com/users/pamlane/following{/other_user}","gists_url":"https://api.github.com/users/pamlane/gists{/gist_id}","starred_url":"https://api.github.com/users/pamlane/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pamlane/subscriptions","organizations_url":"https://api.github.com/users/pamlane/orgs","repos_url":"https://api.github.com/users/pamlane/repos","events_url":"https://api.github.com/users/pamlane/events{/privacy}","received_events_url":"https://api.github.com/users/pamlane/received_events","type":"User","site_admin":false},"body":"Minor changes:\r\nWhen your application is successfully submitted and started on a Streams environment, the application uses the tracing levels set by the `--traceRuntime`. All messages, including standard output and error, are logged to log files on the distributed environment. After the job is running, you can change the application trace level for individual operators (transforms), processing elements (PEs), or the entire job from Streams Console.","created_at":"2018-06-07T19:10:13Z","updated_at":"2018-06-07T19:10:13Z","html_url":"https://github.com/pgerv12/streamsx.documentation/pull/11#discussion_r193858893","pull_request_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/comments/193858893"},"html":{"href":"https://github.com/pgerv12/streamsx.documentation/pull/11#discussion_r193858893"},"pull_request":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11"}}},"pull_request":{"url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11","id":193149353,"node_id":"MDExOlB1bGxSZXF1ZXN0MTkzMTQ5MzUz","html_url":"https://github.com/pgerv12/streamsx.documentation/pull/11","diff_url":"https://github.com/pgerv12/streamsx.documentation/pull/11.diff","patch_url":"https://github.com/pgerv12/streamsx.documentation/pull/11.patch","issue_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/11","number":11,"state":"open","locked":false,"title":"Add troubleshooting guide","user":{"login":"pgerv12","id":5805941,"node_id":"MDQ6VXNlcjU4MDU5NDE=","avatar_url":"https://avatars0.githubusercontent.com/u/5805941?v=4","gravatar_id":"","url":"https://api.github.com/users/pgerv12","html_url":"https://github.com/pgerv12","followers_url":"https://api.github.com/users/pgerv12/followers","following_url":"https://api.github.com/users/pgerv12/following{/other_user}","gists_url":"https://api.github.com/users/pgerv12/gists{/gist_id}","starred_url":"https://api.github.com/users/pgerv12/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgerv12/subscriptions","organizations_url":"https://api.github.com/users/pgerv12/orgs","repos_url":"https://api.github.com/users/pgerv12/repos","events_url":"https://api.github.com/users/pgerv12/events{/privacy}","received_events_url":"https://api.github.com/users/pgerv12/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-06-06T21:43:56Z","updated_at":"2018-06-07T19:10:13Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e274deda8f652ce4fbfe28e7169ec93e21b9d496","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11/commits","review_comments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11/comments","review_comment_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/11/comments","statuses_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/statuses/236f0f06384a25c2459e450857bec1f075bd39f2","head":{"label":"pgerv12:troubleshoot","ref":"troubleshoot","sha":"236f0f06384a25c2459e450857bec1f075bd39f2","user":{"login":"pgerv12","id":5805941,"node_id":"MDQ6VXNlcjU4MDU5NDE=","avatar_url":"https://avatars0.githubusercontent.com/u/5805941?v=4","gravatar_id":"","url":"https://api.github.com/users/pgerv12","html_url":"https://github.com/pgerv12","followers_url":"https://api.github.com/users/pgerv12/followers","following_url":"https://api.github.com/users/pgerv12/following{/other_user}","gists_url":"https://api.github.com/users/pgerv12/gists{/gist_id}","starred_url":"https://api.github.com/users/pgerv12/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgerv12/subscriptions","organizations_url":"https://api.github.com/users/pgerv12/orgs","repos_url":"https://api.github.com/users/pgerv12/repos","events_url":"https://api.github.com/users/pgerv12/events{/privacy}","received_events_url":"https://api.github.com/users/pgerv12/received_events","type":"User","site_admin":false},"repo":{"id":105690768,"node_id":"MDEwOlJlcG9zaXRvcnkxMDU2OTA3Njg=","name":"streamsx.documentation","full_name":"pgerv12/streamsx.documentation","owner":{"login":"pgerv12","id":5805941,"node_id":"MDQ6VXNlcjU4MDU5NDE=","avatar_url":"https://avatars0.githubusercontent.com/u/5805941?v=4","gravatar_id":"","url":"https://api.github.com/users/pgerv12","html_url":"https://github.com/pgerv12","followers_url":"https://api.github.com/users/pgerv12/followers","following_url":"https://api.github.com/users/pgerv12/following{/other_user}","gists_url":"https://api.github.com/users/pgerv12/gists{/gist_id}","starred_url":"https://api.github.com/users/pgerv12/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgerv12/subscriptions","organizations_url":"https://api.github.com/users/pgerv12/orgs","repos_url":"https://api.github.com/users/pgerv12/repos","events_url":"https://api.github.com/users/pgerv12/events{/privacy}","received_events_url":"https://api.github.com/users/pgerv12/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/pgerv12/streamsx.documentation","description":"(Incubation)  Streams documentation project for writing development guides and documentation","fork":true,"url":"https://api.github.com/repos/pgerv12/streamsx.documentation","forks_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/forks","keys_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/teams","hooks_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/hooks","issue_events_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/events{/number}","events_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/events","assignees_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/assignees{/user}","branches_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/branches{/branch}","tags_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/tags","blobs_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/languages","stargazers_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/stargazers","contributors_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/contributors","subscribers_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/subscribers","subscription_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/subscription","commits_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/contents/{+path}","compare_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/merges","archive_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/downloads","issues_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues{/number}","pulls_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/labels{/name}","releases_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/releases{/id}","deployments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/deployments","created_at":"2017-10-03T18:56:33Z","updated_at":"2018-06-05T21:48:55Z","pushed_at":"2018-06-07T18:33:11Z","git_url":"git://github.com/pgerv12/streamsx.documentation.git","ssh_url":"git@github.com:pgerv12/streamsx.documentation.git","clone_url":"https://github.com/pgerv12/streamsx.documentation.git","svn_url":"https://github.com/pgerv12/streamsx.documentation","homepage":"http://ibmstreams.github.io/streamsx.documentation","size":25489,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":2,"license":null,"forks":1,"open_issues":2,"watchers":0,"default_branch":"gh-pages"}},"base":{"label":"pgerv12:gh-pages","ref":"gh-pages","sha":"f216fe4334180db159154516aa2e56f9eda6306c","user":{"login":"pgerv12","id":5805941,"node_id":"MDQ6VXNlcjU4MDU5NDE=","avatar_url":"https://avatars0.githubusercontent.com/u/5805941?v=4","gravatar_id":"","url":"https://api.github.com/users/pgerv12","html_url":"https://github.com/pgerv12","followers_url":"https://api.github.com/users/pgerv12/followers","following_url":"https://api.github.com/users/pgerv12/following{/other_user}","gists_url":"https://api.github.com/users/pgerv12/gists{/gist_id}","starred_url":"https://api.github.com/users/pgerv12/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgerv12/subscriptions","organizations_url":"https://api.github.com/users/pgerv12/orgs","repos_url":"https://api.github.com/users/pgerv12/repos","events_url":"https://api.github.com/users/pgerv12/events{/privacy}","received_events_url":"https://api.github.com/users/pgerv12/received_events","type":"User","site_admin":false},"repo":{"id":105690768,"node_id":"MDEwOlJlcG9zaXRvcnkxMDU2OTA3Njg=","name":"streamsx.documentation","full_name":"pgerv12/streamsx.documentation","owner":{"login":"pgerv12","id":5805941,"node_id":"MDQ6VXNlcjU4MDU5NDE=","avatar_url":"https://avatars0.githubusercontent.com/u/5805941?v=4","gravatar_id":"","url":"https://api.github.com/users/pgerv12","html_url":"https://github.com/pgerv12","followers_url":"https://api.github.com/users/pgerv12/followers","following_url":"https://api.github.com/users/pgerv12/following{/other_user}","gists_url":"https://api.github.com/users/pgerv12/gists{/gist_id}","starred_url":"https://api.github.com/users/pgerv12/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pgerv12/subscriptions","organizations_url":"https://api.github.com/users/pgerv12/orgs","repos_url":"https://api.github.com/users/pgerv12/repos","events_url":"https://api.github.com/users/pgerv12/events{/privacy}","received_events_url":"https://api.github.com/users/pgerv12/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/pgerv12/streamsx.documentation","description":"(Incubation)  Streams documentation project for writing development guides and documentation","fork":true,"url":"https://api.github.com/repos/pgerv12/streamsx.documentation","forks_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/forks","keys_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/teams","hooks_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/hooks","issue_events_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/events{/number}","events_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/events","assignees_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/assignees{/user}","branches_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/branches{/branch}","tags_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/tags","blobs_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/languages","stargazers_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/stargazers","contributors_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/contributors","subscribers_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/subscribers","subscription_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/subscription","commits_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/contents/{+path}","compare_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/merges","archive_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/downloads","issues_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues{/number}","pulls_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/labels{/name}","releases_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/releases{/id}","deployments_url":"https://api.github.com/repos/pgerv12/streamsx.documentation/deployments","created_at":"2017-10-03T18:56:33Z","updated_at":"2018-06-05T21:48:55Z","pushed_at":"2018-06-07T18:33:11Z","git_url":"git://github.com/pgerv12/streamsx.documentation.git","ssh_url":"git@github.com:pgerv12/streamsx.documentation.git","clone_url":"https://github.com/pgerv12/streamsx.documentation.git","svn_url":"https://github.com/pgerv12/streamsx.documentation","homepage":"http://ibmstreams.github.io/streamsx.documentation","size":25489,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":2,"license":null,"forks":1,"open_issues":2,"watchers":0,"default_branch":"gh-pages"}},"_links":{"self":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11"},"html":{"href":"https://github.com/pgerv12/streamsx.documentation/pull/11"},"issue":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/11"},"comments":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/issues/11/comments"},"review_comments":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11/comments"},"review_comment":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/pulls/11/commits"},"statuses":{"href":"https://api.github.com/repos/pgerv12/streamsx.documentation/statuses/236f0f06384a25c2459e450857bec1f075bd39f2"}},"author_association":"OWNER"}}
{"actor":{"display_login":"pamlane"}}