{"action":"created","comment":{"url":"https://api.github.com/repos/istio/istio.io/pulls/comments/334674581","pull_request_review_id":301555143,"id":334674581,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDMzNDY3NDU4MQ==","diff_hunk":"@@ -0,0 +1,106 @@\n+---\n+title: Analyze your cluster and local configuration with istioctl analyze\n+description: Shows you how to use istioctl analyze to identify potential issues with your configuration.\n+weight: 90\n+keywords: [istioctl, debugging, kubernetes]\n+---\n+\n+{{< boilerplate experimental-feature-warning >}}\n+\n+## Getting started in under a minute\n+\n+`Istioctl analyze` is a powerful Istio diagnostic command that you can get started with in no time, and on any cluster.\n+\n+First, download the latest `istioctl` into the current folder using one bash command:\n+\n+Mac:\n+\n+{{< text bash >}}\n+$ curl https://storage.googleapis.com/istio-build/dev/latest | xargs -I {} curl https://storage.googleapis.com/istio-build/dev/{}/istioctl-{}-osx.tar.gz | tar xvz\n+{{< /text >}}\n+\n+Linux:\n+\n+{{< text bash >}}\n+$ curl https://storage.googleapis.com/istio-build/dev/latest | xargs -I {} curl https://storage.googleapis.com/istio-build/dev/{}/istioctl-{}-linux.tar.gz | tar xvz\n+{{< /text >}}\n+\n+Then, run it against your current Kubernetes cluster:\n+\n+{{< text bash >}}\n+$ ./istioctl x analyze -k\n+{{< /text >}}\n+\n+And that’s it! It’ll give you any recommendations that apply.\n+\n+For example, if you forgot to enable Istio injection (very common issue), you would get the following warning:\n+\n+{{< text plain >}}\n+Warn [IST0102](Namespace/default) The namespace is not enabled for Istio injection. Run 'kubectl label namespace default istio-injection=enabled' to enable it, or 'kubectl label namespace default istio-injection=disabled' to explicitly mark it as not needing injection\n+{{< /text >}}\n+\n+Notes: the ‘x’ in the command is because it’s currently ‘eXperimental’. It will eventually just be `istioctl analyze`.\n+\n+## Analyzing live clusters, local files, or both\n+\n+The scenario in the ‘getting started’ section is doing analysis on live cluster. But the tool also supports performing analysis of a set of local yaml configuration files, or on a combination of local files and a live cluster.\n+\n+{{< text bash >}}\n+$\n+# Analyze a specific set of local files\n+$ ./istioctl x analyze a.yaml b.yaml\n+\n+# Analyze all yaml files in the current folder\n+$ ./istioctl x analyze *.yaml\n+\n+# Analyze the current live cluster, simulating the effect of applying additional yaml files\n+$ ./istioctl x analyze -k a.yaml b.yaml\n+{{< /text >}}\n+\n+You can run `./istioctl x analyze --help` to see the full set of options.\n+\n+## Helping us make improve this tool","path":"content/en/docs/ops/troubleshooting/istioctl-analyze/index.md","position":null,"original_position":62,"commit_id":"b2a67d654a5efbfb1e5235edc461e0b47564a898","original_commit_id":"e31104df3eba7cecc84b3499a4d1d027fc5fd26b","user":{"login":"davidebbo","id":556238,"node_id":"MDQ6VXNlcjU1NjIzOA==","avatar_url":"https://avatars1.githubusercontent.com/u/556238?v=4","gravatar_id":"","url":"https://api.github.com/users/davidebbo","html_url":"https://github.com/davidebbo","followers_url":"https://api.github.com/users/davidebbo/followers","following_url":"https://api.github.com/users/davidebbo/following{/other_user}","gists_url":"https://api.github.com/users/davidebbo/gists{/gist_id}","starred_url":"https://api.github.com/users/davidebbo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidebbo/subscriptions","organizations_url":"https://api.github.com/users/davidebbo/orgs","repos_url":"https://api.github.com/users/davidebbo/repos","events_url":"https://api.github.com/users/davidebbo/events{/privacy}","received_events_url":"https://api.github.com/users/davidebbo/received_events","type":"User","site_admin":false},"body":"Agreed, and @selmanj is going to look at that scenario, but right now I don't want to block the initial doc on not having that.","created_at":"2019-10-14T21:42:36Z","updated_at":"2019-10-14T21:42:36Z","html_url":"https://github.com/istio/istio.io/pull/5147#discussion_r334674581","pull_request_url":"https://api.github.com/repos/istio/istio.io/pulls/5147","author_association":"NONE","_links":{"self":{"href":"https://api.github.com/repos/istio/istio.io/pulls/comments/334674581"},"html":{"href":"https://github.com/istio/istio.io/pull/5147#discussion_r334674581"},"pull_request":{"href":"https://api.github.com/repos/istio/istio.io/pulls/5147"}},"in_reply_to_id":334510360},"pull_request":{"url":"https://api.github.com/repos/istio/istio.io/pulls/5147","id":327623829,"node_id":"MDExOlB1bGxSZXF1ZXN0MzI3NjIzODI5","html_url":"https://github.com/istio/istio.io/pull/5147","diff_url":"https://github.com/istio/istio.io/pull/5147.diff","patch_url":"https://github.com/istio/istio.io/pull/5147.patch","issue_url":"https://api.github.com/repos/istio/istio.io/issues/5147","number":5147,"state":"open","locked":false,"title":"Add doc page for 'istioctl analyze'","user":{"login":"davidebbo","id":556238,"node_id":"MDQ6VXNlcjU1NjIzOA==","avatar_url":"https://avatars1.githubusercontent.com/u/556238?v=4","gravatar_id":"","url":"https://api.github.com/users/davidebbo","html_url":"https://github.com/davidebbo","followers_url":"https://api.github.com/users/davidebbo/followers","following_url":"https://api.github.com/users/davidebbo/following{/other_user}","gists_url":"https://api.github.com/users/davidebbo/gists{/gist_id}","starred_url":"https://api.github.com/users/davidebbo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidebbo/subscriptions","organizations_url":"https://api.github.com/users/davidebbo/orgs","repos_url":"https://api.github.com/users/davidebbo/repos","events_url":"https://api.github.com/users/davidebbo/events{/privacy}","received_events_url":"https://api.github.com/users/davidebbo/received_events","type":"User","site_admin":false},"body":"Please provide a description for what this PR is for.\r\n\r\nAnd to help us figure out who should review this PR, please \r\nput an X in all the areas that this PR affects.\r\n\r\n[ ] Configuration Infrastructure\r\n[X] Docs\r\n[ ] Installation\r\n[ ] Networking\r\n[ ] Performance and Scalability\r\n[ ] Policies and Telemetry\r\n[ ] Security\r\n[ ] Test and Release\r\n[X] User Experience\r\n[ ] Developer Infrastructure\r\n","created_at":"2019-10-14T02:51:56Z","updated_at":"2019-10-14T21:42:36Z","closed_at":null,"merged_at":null,"merge_commit_sha":"58b81d26de7d08e46943c8225eee25883953ddb0","assignee":{"login":"geeknoid","id":22780957,"node_id":"MDQ6VXNlcjIyNzgwOTU3","avatar_url":"https://avatars3.githubusercontent.com/u/22780957?v=4","gravatar_id":"","url":"https://api.github.com/users/geeknoid","html_url":"https://github.com/geeknoid","followers_url":"https://api.github.com/users/geeknoid/followers","following_url":"https://api.github.com/users/geeknoid/following{/other_user}","gists_url":"https://api.github.com/users/geeknoid/gists{/gist_id}","starred_url":"https://api.github.com/users/geeknoid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geeknoid/subscriptions","organizations_url":"https://api.github.com/users/geeknoid/orgs","repos_url":"https://api.github.com/users/geeknoid/repos","events_url":"https://api.github.com/users/geeknoid/events{/privacy}","received_events_url":"https://api.github.com/users/geeknoid/received_events","type":"User","site_admin":false},"assignees":[{"login":"geeknoid","id":22780957,"node_id":"MDQ6VXNlcjIyNzgwOTU3","avatar_url":"https://avatars3.githubusercontent.com/u/22780957?v=4","gravatar_id":"","url":"https://api.github.com/users/geeknoid","html_url":"https://github.com/geeknoid","followers_url":"https://api.github.com/users/geeknoid/followers","following_url":"https://api.github.com/users/geeknoid/following{/other_user}","gists_url":"https://api.github.com/users/geeknoid/gists{/gist_id}","starred_url":"https://api.github.com/users/geeknoid/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/geeknoid/subscriptions","organizations_url":"https://api.github.com/users/geeknoid/orgs","repos_url":"https://api.github.com/users/geeknoid/repos","events_url":"https://api.github.com/users/geeknoid/events{/privacy}","received_events_url":"https://api.github.com/users/geeknoid/received_events","type":"User","site_admin":false}],"requested_reviewers":[],"requested_teams":[],"labels":[{"id":1463979886,"node_id":"MDU6TGFiZWwxNDYzOTc5ODg2","url":"https://api.github.com/repos/istio/istio.io/labels/cla:%20yes","name":"cla: yes","color":"bfdadc","default":false},{"id":1448953250,"node_id":"MDU6TGFiZWwxNDQ4OTUzMjUw","url":"https://api.github.com/repos/istio/istio.io/labels/size/L","name":"size/L","color":"77bb00","default":false}],"milestone":null,"commits_url":"https://api.github.com/repos/istio/istio.io/pulls/5147/commits","review_comments_url":"https://api.github.com/repos/istio/istio.io/pulls/5147/comments","review_comment_url":"https://api.github.com/repos/istio/istio.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/istio/istio.io/issues/5147/comments","statuses_url":"https://api.github.com/repos/istio/istio.io/statuses/b2a67d654a5efbfb1e5235edc461e0b47564a898","head":{"label":"davidebbo:master","ref":"master","sha":"b2a67d654a5efbfb1e5235edc461e0b47564a898","user":{"login":"davidebbo","id":556238,"node_id":"MDQ6VXNlcjU1NjIzOA==","avatar_url":"https://avatars1.githubusercontent.com/u/556238?v=4","gravatar_id":"","url":"https://api.github.com/users/davidebbo","html_url":"https://github.com/davidebbo","followers_url":"https://api.github.com/users/davidebbo/followers","following_url":"https://api.github.com/users/davidebbo/following{/other_user}","gists_url":"https://api.github.com/users/davidebbo/gists{/gist_id}","starred_url":"https://api.github.com/users/davidebbo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidebbo/subscriptions","organizations_url":"https://api.github.com/users/davidebbo/orgs","repos_url":"https://api.github.com/users/davidebbo/repos","events_url":"https://api.github.com/users/davidebbo/events{/privacy}","received_events_url":"https://api.github.com/users/davidebbo/received_events","type":"User","site_admin":false},"repo":{"id":214911720,"node_id":"MDEwOlJlcG9zaXRvcnkyMTQ5MTE3MjA=","name":"istio.io","full_name":"davidebbo/istio.io","private":false,"owner":{"login":"davidebbo","id":556238,"node_id":"MDQ6VXNlcjU1NjIzOA==","avatar_url":"https://avatars1.githubusercontent.com/u/556238?v=4","gravatar_id":"","url":"https://api.github.com/users/davidebbo","html_url":"https://github.com/davidebbo","followers_url":"https://api.github.com/users/davidebbo/followers","following_url":"https://api.github.com/users/davidebbo/following{/other_user}","gists_url":"https://api.github.com/users/davidebbo/gists{/gist_id}","starred_url":"https://api.github.com/users/davidebbo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidebbo/subscriptions","organizations_url":"https://api.github.com/users/davidebbo/orgs","repos_url":"https://api.github.com/users/davidebbo/repos","events_url":"https://api.github.com/users/davidebbo/events{/privacy}","received_events_url":"https://api.github.com/users/davidebbo/received_events","type":"User","site_admin":false},"html_url":"https://github.com/davidebbo/istio.io","description":"Source for the istio.io site","fork":true,"url":"https://api.github.com/repos/davidebbo/istio.io","forks_url":"https://api.github.com/repos/davidebbo/istio.io/forks","keys_url":"https://api.github.com/repos/davidebbo/istio.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/davidebbo/istio.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/davidebbo/istio.io/teams","hooks_url":"https://api.github.com/repos/davidebbo/istio.io/hooks","issue_events_url":"https://api.github.com/repos/davidebbo/istio.io/issues/events{/number}","events_url":"https://api.github.com/repos/davidebbo/istio.io/events","assignees_url":"https://api.github.com/repos/davidebbo/istio.io/assignees{/user}","branches_url":"https://api.github.com/repos/davidebbo/istio.io/branches{/branch}","tags_url":"https://api.github.com/repos/davidebbo/istio.io/tags","blobs_url":"https://api.github.com/repos/davidebbo/istio.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/davidebbo/istio.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/davidebbo/istio.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/davidebbo/istio.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/davidebbo/istio.io/statuses/{sha}","languages_url":"https://api.github.com/repos/davidebbo/istio.io/languages","stargazers_url":"https://api.github.com/repos/davidebbo/istio.io/stargazers","contributors_url":"https://api.github.com/repos/davidebbo/istio.io/contributors","subscribers_url":"https://api.github.com/repos/davidebbo/istio.io/subscribers","subscription_url":"https://api.github.com/repos/davidebbo/istio.io/subscription","commits_url":"https://api.github.com/repos/davidebbo/istio.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/davidebbo/istio.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/davidebbo/istio.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/davidebbo/istio.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/davidebbo/istio.io/contents/{+path}","compare_url":"https://api.github.com/repos/davidebbo/istio.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/davidebbo/istio.io/merges","archive_url":"https://api.github.com/repos/davidebbo/istio.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/davidebbo/istio.io/downloads","issues_url":"https://api.github.com/repos/davidebbo/istio.io/issues{/number}","pulls_url":"https://api.github.com/repos/davidebbo/istio.io/pulls{/number}","milestones_url":"https://api.github.com/repos/davidebbo/istio.io/milestones{/number}","notifications_url":"https://api.github.com/repos/davidebbo/istio.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/davidebbo/istio.io/labels{/name}","releases_url":"https://api.github.com/repos/davidebbo/istio.io/releases{/id}","deployments_url":"https://api.github.com/repos/davidebbo/istio.io/deployments","created_at":"2019-10-13T23:56:42Z","updated_at":"2019-10-14T21:31:50Z","pushed_at":"2019-10-14T21:31:48Z","git_url":"git://github.com/davidebbo/istio.io.git","ssh_url":"git@github.com:davidebbo/istio.io.git","clone_url":"https://github.com/davidebbo/istio.io.git","svn_url":"https://github.com/davidebbo/istio.io","homepage":"https://istio.io/","size":54794,"stargazers_count":0,"watchers_count":0,"language":"HTML","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":0,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"istio:master","ref":"master","sha":"e3a735e03f92e7230a7863fa45f0eccd8ac80a68","user":{"login":"istio","id":23534644,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzNTM0NjQ0","avatar_url":"https://avatars1.githubusercontent.com/u/23534644?v=4","gravatar_id":"","url":"https://api.github.com/users/istio","html_url":"https://github.com/istio","followers_url":"https://api.github.com/users/istio/followers","following_url":"https://api.github.com/users/istio/following{/other_user}","gists_url":"https://api.github.com/users/istio/gists{/gist_id}","starred_url":"https://api.github.com/users/istio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/istio/subscriptions","organizations_url":"https://api.github.com/users/istio/orgs","repos_url":"https://api.github.com/users/istio/repos","events_url":"https://api.github.com/users/istio/events{/privacy}","received_events_url":"https://api.github.com/users/istio/received_events","type":"Organization","site_admin":false},"repo":{"id":82706976,"node_id":"MDEwOlJlcG9zaXRvcnk4MjcwNjk3Ng==","name":"istio.io","full_name":"istio/istio.io","private":false,"owner":{"login":"istio","id":23534644,"node_id":"MDEyOk9yZ2FuaXphdGlvbjIzNTM0NjQ0","avatar_url":"https://avatars1.githubusercontent.com/u/23534644?v=4","gravatar_id":"","url":"https://api.github.com/users/istio","html_url":"https://github.com/istio","followers_url":"https://api.github.com/users/istio/followers","following_url":"https://api.github.com/users/istio/following{/other_user}","gists_url":"https://api.github.com/users/istio/gists{/gist_id}","starred_url":"https://api.github.com/users/istio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/istio/subscriptions","organizations_url":"https://api.github.com/users/istio/orgs","repos_url":"https://api.github.com/users/istio/repos","events_url":"https://api.github.com/users/istio/events{/privacy}","received_events_url":"https://api.github.com/users/istio/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/istio/istio.io","description":"Source for the istio.io site","fork":false,"url":"https://api.github.com/repos/istio/istio.io","forks_url":"https://api.github.com/repos/istio/istio.io/forks","keys_url":"https://api.github.com/repos/istio/istio.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/istio/istio.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/istio/istio.io/teams","hooks_url":"https://api.github.com/repos/istio/istio.io/hooks","issue_events_url":"https://api.github.com/repos/istio/istio.io/issues/events{/number}","events_url":"https://api.github.com/repos/istio/istio.io/events","assignees_url":"https://api.github.com/repos/istio/istio.io/assignees{/user}","branches_url":"https://api.github.com/repos/istio/istio.io/branches{/branch}","tags_url":"https://api.github.com/repos/istio/istio.io/tags","blobs_url":"https://api.github.com/repos/istio/istio.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/istio/istio.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/istio/istio.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/istio/istio.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/istio/istio.io/statuses/{sha}","languages_url":"https://api.github.com/repos/istio/istio.io/languages","stargazers_url":"https://api.github.com/repos/istio/istio.io/stargazers","contributors_url":"https://api.github.com/repos/istio/istio.io/contributors","subscribers_url":"https://api.github.com/repos/istio/istio.io/subscribers","subscription_url":"https://api.github.com/repos/istio/istio.io/subscription","commits_url":"https://api.github.com/repos/istio/istio.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/istio/istio.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/istio/istio.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/istio/istio.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/istio/istio.io/contents/{+path}","compare_url":"https://api.github.com/repos/istio/istio.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/istio/istio.io/merges","archive_url":"https://api.github.com/repos/istio/istio.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/istio/istio.io/downloads","issues_url":"https://api.github.com/repos/istio/istio.io/issues{/number}","pulls_url":"https://api.github.com/repos/istio/istio.io/pulls{/number}","milestones_url":"https://api.github.com/repos/istio/istio.io/milestones{/number}","notifications_url":"https://api.github.com/repos/istio/istio.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/istio/istio.io/labels{/name}","releases_url":"https://api.github.com/repos/istio/istio.io/releases{/id}","deployments_url":"https://api.github.com/repos/istio/istio.io/deployments","created_at":"2017-02-21T17:19:49Z","updated_at":"2019-10-14T20:02:01Z","pushed_at":"2019-10-14T21:31:50Z","git_url":"git://github.com/istio/istio.io.git","ssh_url":"git@github.com:istio/istio.io.git","clone_url":"https://github.com/istio/istio.io.git","svn_url":"https://github.com/istio/istio.io","homepage":"https://istio.io/","size":54809,"stargazers_count":356,"watchers_count":356,"language":"HTML","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":646,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":224,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0","node_id":"MDc6TGljZW5zZTI="},"forks":646,"open_issues":224,"watchers":356,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/istio/istio.io/pulls/5147"},"html":{"href":"https://github.com/istio/istio.io/pull/5147"},"issue":{"href":"https://api.github.com/repos/istio/istio.io/issues/5147"},"comments":{"href":"https://api.github.com/repos/istio/istio.io/issues/5147/comments"},"review_comments":{"href":"https://api.github.com/repos/istio/istio.io/pulls/5147/comments"},"review_comment":{"href":"https://api.github.com/repos/istio/istio.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/istio/istio.io/pulls/5147/commits"},"statuses":{"href":"https://api.github.com/repos/istio/istio.io/statuses/b2a67d654a5efbfb1e5235edc461e0b47564a898"}},"author_association":"NONE"}}
{"actor":{"display_login":"davidebbo"}}