{"action":"created","comment":{"url":"https://api.github.com/repos/elasticsearch/kibana/pulls/comments/24454863","id":24454863,"diff_hunk":"@@ -1,2 +1,131 @@\n [[visualize]]\n-== Visualizing your Data\n\\ No newline at end of file\n+== Visualize\n+\n+You can use Kibana's _Visualize_ app to design and create data visualizations. You can save these visualizations, use\n+them individually, or combine visualizations into a _dashboard_. A visualization can be based on one of the following \n+data source types:\n+\n+* A new interactive search\n+* A saved search\n+* An existing saved visualization\n+\n+Visualizations are based on the {ref}/search-aggregations.html[aggregation] feature introduced in Elasticsearch 1. \n+\n+[float]\n+[[getting-started]]\n+=== Creating a New Visualization\n+\n+To start the New Visualization wizard, click on the *Visualize* tab at the top left of the screen. Alternately, you can \n+click the *New Visualization* button image:images/K4NewDocument.png[New Document button] in the toolbar panel to the \n+right of the search bar. The wizard guides you through the following steps:\n+\n+[float]\n+[[newvis01]]\n+==== Step 1: Choose the Visualization Type\n+\n+The New Visualization wizard starts with the following screen:\n+\n+image:images/NewViz01.png[]\n+\n+The data table, Markdown, and metric elements aren't visualizations, but all the elements on the list can be included \n+in a <<dashboard,Dashboard>>.\n+\n+You can also open a saved visualization that you created earlier. The saved visualization selector includes a text \n+field to filter by visualization name and a link to the Object Editor, accessible through *Settings > Edit Saved \n+Objects*, to manage your saved visualizations.\n+\n+If your new visualization is a Markdown widget, selecting that type takes you to a text entry field where you enter the \n+text to display in the widget. For all other types of visualization, selecting the type takes you to data source \n+selection.\n+\n+[float]\n+[[newvis02]]\n+==== Step 2: Choose a Data Source\n+\n+You can choose a new or saved search to serve as the data source for your visualization. Searches are based on an \n+_index pattern_, which is a regular expression that matches the indices you want to visualize. After selecting _new \n+search_, select an index pattern from the drop-down to bring up the visualization editor. \n+\n+// How is this drop-down populated? Is it just a list of all indices in the cluster? Can I configure the contents?\n+\n+When you create a visualization from a saved search and save the visualization, the search is tied to the visualization.\n+When you make changes to the search that is linked to the visualization, the visualization updates automatically.\n+\n+[float]\n+[[visualization-editor]]\n+==== Step 3: The Visualization Editor\n+\n+The visualization editor enables you to configure and edit visualizations. The visualization editor has the following \n+main elements:","path":"docs/visualize.asciidoc","position":61,"original_position":61,"commit_id":"fce76c4c1f3987a1ed3ba8025eb96f8b405287ae","original_commit_id":"fce76c4c1f3987a1ed3ba8025eb96f8b405287ae","user":{"login":"debadair","id":362578,"avatar_url":"https://avatars.githubusercontent.com/u/362578?v=3","gravatar_id":"","url":"https://api.github.com/users/debadair","html_url":"https://github.com/debadair","followers_url":"https://api.github.com/users/debadair/followers","following_url":"https://api.github.com/users/debadair/following{/other_user}","gists_url":"https://api.github.com/users/debadair/gists{/gist_id}","starred_url":"https://api.github.com/users/debadair/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/debadair/subscriptions","organizations_url":"https://api.github.com/users/debadair/orgs","repos_url":"https://api.github.com/users/debadair/repos","events_url":"https://api.github.com/users/debadair/events{/privacy}","received_events_url":"https://api.github.com/users/debadair/received_events","type":"User","site_admin":false},"body":"\"has three main components\"? I'd be inclined to list them before the image.","created_at":"2015-02-10T21:58:14Z","updated_at":"2015-02-10T21:58:14Z","html_url":"https://github.com/elasticsearch/kibana/pull/2961#discussion_r24454863","pull_request_url":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961","_links":{"self":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/comments/24454863"},"html":{"href":"https://github.com/elasticsearch/kibana/pull/2961#discussion_r24454863"},"pull_request":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961"}}},"pull_request":{"url":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961","id":28978040,"html_url":"https://github.com/elasticsearch/kibana/pull/2961","diff_url":"https://github.com/elasticsearch/kibana/pull/2961.diff","patch_url":"https://github.com/elasticsearch/kibana/pull/2961.patch","issue_url":"https://api.github.com/repos/elasticsearch/kibana/issues/2961","number":2961,"state":"closed","locked":false,"title":"Visualize & Dashboard chapters for K4 documentation, initial draft.","user":{"login":"palecur","id":1779279,"avatar_url":"https://avatars.githubusercontent.com/u/1779279?v=3","gravatar_id":"","url":"https://api.github.com/users/palecur","html_url":"https://github.com/palecur","followers_url":"https://api.github.com/users/palecur/followers","following_url":"https://api.github.com/users/palecur/following{/other_user}","gists_url":"https://api.github.com/users/palecur/gists{/gist_id}","starred_url":"https://api.github.com/users/palecur/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/palecur/subscriptions","organizations_url":"https://api.github.com/users/palecur/orgs","repos_url":"https://api.github.com/users/palecur/repos","events_url":"https://api.github.com/users/palecur/events{/privacy}","received_events_url":"https://api.github.com/users/palecur/received_events","type":"User","site_admin":false},"body":"This should merge pretty straightforwardly with @debadair's work on Getting Started & Settings. Please review.","created_at":"2015-02-10T03:20:09Z","updated_at":"2015-02-10T21:58:14Z","closed_at":"2015-02-10T17:59:27Z","merged_at":null,"merge_commit_sha":"4a9e6629f93504d7c8a300efcabb0a4bed86b276","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961/commits","review_comments_url":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961/comments","review_comment_url":"https://api.github.com/repos/elasticsearch/kibana/pulls/comments/{number}","comments_url":"https://api.github.com/repos/elasticsearch/kibana/issues/2961/comments","statuses_url":"https://api.github.com/repos/elasticsearch/kibana/statuses/fce76c4c1f3987a1ed3ba8025eb96f8b405287ae","head":{"label":"palecur:doc-alpha","ref":"doc-alpha","sha":"fce76c4c1f3987a1ed3ba8025eb96f8b405287ae","user":{"login":"palecur","id":1779279,"avatar_url":"https://avatars.githubusercontent.com/u/1779279?v=3","gravatar_id":"","url":"https://api.github.com/users/palecur","html_url":"https://github.com/palecur","followers_url":"https://api.github.com/users/palecur/followers","following_url":"https://api.github.com/users/palecur/following{/other_user}","gists_url":"https://api.github.com/users/palecur/gists{/gist_id}","starred_url":"https://api.github.com/users/palecur/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/palecur/subscriptions","organizations_url":"https://api.github.com/users/palecur/orgs","repos_url":"https://api.github.com/users/palecur/repos","events_url":"https://api.github.com/users/palecur/events{/privacy}","received_events_url":"https://api.github.com/users/palecur/received_events","type":"User","site_admin":false},"repo":{"id":29940741,"name":"kibana","full_name":"palecur/kibana","owner":{"login":"palecur","id":1779279,"avatar_url":"https://avatars.githubusercontent.com/u/1779279?v=3","gravatar_id":"","url":"https://api.github.com/users/palecur","html_url":"https://github.com/palecur","followers_url":"https://api.github.com/users/palecur/followers","following_url":"https://api.github.com/users/palecur/following{/other_user}","gists_url":"https://api.github.com/users/palecur/gists{/gist_id}","starred_url":"https://api.github.com/users/palecur/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/palecur/subscriptions","organizations_url":"https://api.github.com/users/palecur/orgs","repos_url":"https://api.github.com/users/palecur/repos","events_url":"https://api.github.com/users/palecur/events{/privacy}","received_events_url":"https://api.github.com/users/palecur/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/palecur/kibana","description":"Kibana","fork":true,"url":"https://api.github.com/repos/palecur/kibana","forks_url":"https://api.github.com/repos/palecur/kibana/forks","keys_url":"https://api.github.com/repos/palecur/kibana/keys{/key_id}","collaborators_url":"https://api.github.com/repos/palecur/kibana/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/palecur/kibana/teams","hooks_url":"https://api.github.com/repos/palecur/kibana/hooks","issue_events_url":"https://api.github.com/repos/palecur/kibana/issues/events{/number}","events_url":"https://api.github.com/repos/palecur/kibana/events","assignees_url":"https://api.github.com/repos/palecur/kibana/assignees{/user}","branches_url":"https://api.github.com/repos/palecur/kibana/branches{/branch}","tags_url":"https://api.github.com/repos/palecur/kibana/tags","blobs_url":"https://api.github.com/repos/palecur/kibana/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/palecur/kibana/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/palecur/kibana/git/refs{/sha}","trees_url":"https://api.github.com/repos/palecur/kibana/git/trees{/sha}","statuses_url":"https://api.github.com/repos/palecur/kibana/statuses/{sha}","languages_url":"https://api.github.com/repos/palecur/kibana/languages","stargazers_url":"https://api.github.com/repos/palecur/kibana/stargazers","contributors_url":"https://api.github.com/repos/palecur/kibana/contributors","subscribers_url":"https://api.github.com/repos/palecur/kibana/subscribers","subscription_url":"https://api.github.com/repos/palecur/kibana/subscription","commits_url":"https://api.github.com/repos/palecur/kibana/commits{/sha}","git_commits_url":"https://api.github.com/repos/palecur/kibana/git/commits{/sha}","comments_url":"https://api.github.com/repos/palecur/kibana/comments{/number}","issue_comment_url":"https://api.github.com/repos/palecur/kibana/issues/comments/{number}","contents_url":"https://api.github.com/repos/palecur/kibana/contents/{+path}","compare_url":"https://api.github.com/repos/palecur/kibana/compare/{base}...{head}","merges_url":"https://api.github.com/repos/palecur/kibana/merges","archive_url":"https://api.github.com/repos/palecur/kibana/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/palecur/kibana/downloads","issues_url":"https://api.github.com/repos/palecur/kibana/issues{/number}","pulls_url":"https://api.github.com/repos/palecur/kibana/pulls{/number}","milestones_url":"https://api.github.com/repos/palecur/kibana/milestones{/number}","notifications_url":"https://api.github.com/repos/palecur/kibana/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/palecur/kibana/labels{/name}","releases_url":"https://api.github.com/repos/palecur/kibana/releases{/id}","created_at":"2015-01-27T23:36:28Z","updated_at":"2015-01-27T23:36:30Z","pushed_at":"2015-02-10T03:18:59Z","git_url":"git://github.com/palecur/kibana.git","ssh_url":"git@github.com:palecur/kibana.git","clone_url":"https://github.com/palecur/kibana.git","svn_url":"https://github.com/palecur/kibana","homepage":"http://www.elasticsearch.org/overview/kibana/","size":42554,"stargazers_count":0,"watchers_count":0,"language":"JavaScript","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"elasticsearch:master","ref":"master","sha":"2dd07442d48e47253cab3f21adaacdf42ecac274","user":{"login":"elasticsearch","id":141304,"avatar_url":"https://avatars.githubusercontent.com/u/141304?v=3","gravatar_id":"","url":"https://api.github.com/users/elasticsearch","html_url":"https://github.com/elasticsearch","followers_url":"https://api.github.com/users/elasticsearch/followers","following_url":"https://api.github.com/users/elasticsearch/following{/other_user}","gists_url":"https://api.github.com/users/elasticsearch/gists{/gist_id}","starred_url":"https://api.github.com/users/elasticsearch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elasticsearch/subscriptions","organizations_url":"https://api.github.com/users/elasticsearch/orgs","repos_url":"https://api.github.com/users/elasticsearch/repos","events_url":"https://api.github.com/users/elasticsearch/events{/privacy}","received_events_url":"https://api.github.com/users/elasticsearch/received_events","type":"Organization","site_admin":false},"repo":{"id":7833168,"name":"kibana","full_name":"elasticsearch/kibana","owner":{"login":"elasticsearch","id":141304,"avatar_url":"https://avatars.githubusercontent.com/u/141304?v=3","gravatar_id":"","url":"https://api.github.com/users/elasticsearch","html_url":"https://github.com/elasticsearch","followers_url":"https://api.github.com/users/elasticsearch/followers","following_url":"https://api.github.com/users/elasticsearch/following{/other_user}","gists_url":"https://api.github.com/users/elasticsearch/gists{/gist_id}","starred_url":"https://api.github.com/users/elasticsearch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elasticsearch/subscriptions","organizations_url":"https://api.github.com/users/elasticsearch/orgs","repos_url":"https://api.github.com/users/elasticsearch/repos","events_url":"https://api.github.com/users/elasticsearch/events{/privacy}","received_events_url":"https://api.github.com/users/elasticsearch/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/elasticsearch/kibana","description":"Kibana","fork":false,"url":"https://api.github.com/repos/elasticsearch/kibana","forks_url":"https://api.github.com/repos/elasticsearch/kibana/forks","keys_url":"https://api.github.com/repos/elasticsearch/kibana/keys{/key_id}","collaborators_url":"https://api.github.com/repos/elasticsearch/kibana/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/elasticsearch/kibana/teams","hooks_url":"https://api.github.com/repos/elasticsearch/kibana/hooks","issue_events_url":"https://api.github.com/repos/elasticsearch/kibana/issues/events{/number}","events_url":"https://api.github.com/repos/elasticsearch/kibana/events","assignees_url":"https://api.github.com/repos/elasticsearch/kibana/assignees{/user}","branches_url":"https://api.github.com/repos/elasticsearch/kibana/branches{/branch}","tags_url":"https://api.github.com/repos/elasticsearch/kibana/tags","blobs_url":"https://api.github.com/repos/elasticsearch/kibana/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/elasticsearch/kibana/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/elasticsearch/kibana/git/refs{/sha}","trees_url":"https://api.github.com/repos/elasticsearch/kibana/git/trees{/sha}","statuses_url":"https://api.github.com/repos/elasticsearch/kibana/statuses/{sha}","languages_url":"https://api.github.com/repos/elasticsearch/kibana/languages","stargazers_url":"https://api.github.com/repos/elasticsearch/kibana/stargazers","contributors_url":"https://api.github.com/repos/elasticsearch/kibana/contributors","subscribers_url":"https://api.github.com/repos/elasticsearch/kibana/subscribers","subscription_url":"https://api.github.com/repos/elasticsearch/kibana/subscription","commits_url":"https://api.github.com/repos/elasticsearch/kibana/commits{/sha}","git_commits_url":"https://api.github.com/repos/elasticsearch/kibana/git/commits{/sha}","comments_url":"https://api.github.com/repos/elasticsearch/kibana/comments{/number}","issue_comment_url":"https://api.github.com/repos/elasticsearch/kibana/issues/comments/{number}","contents_url":"https://api.github.com/repos/elasticsearch/kibana/contents/{+path}","compare_url":"https://api.github.com/repos/elasticsearch/kibana/compare/{base}...{head}","merges_url":"https://api.github.com/repos/elasticsearch/kibana/merges","archive_url":"https://api.github.com/repos/elasticsearch/kibana/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/elasticsearch/kibana/downloads","issues_url":"https://api.github.com/repos/elasticsearch/kibana/issues{/number}","pulls_url":"https://api.github.com/repos/elasticsearch/kibana/pulls{/number}","milestones_url":"https://api.github.com/repos/elasticsearch/kibana/milestones{/number}","notifications_url":"https://api.github.com/repos/elasticsearch/kibana/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/elasticsearch/kibana/labels{/name}","releases_url":"https://api.github.com/repos/elasticsearch/kibana/releases{/id}","created_at":"2013-01-26T04:00:59Z","updated_at":"2015-02-10T21:49:41Z","pushed_at":"2015-02-10T21:49:41Z","git_url":"git://github.com/elasticsearch/kibana.git","ssh_url":"git@github.com:elasticsearch/kibana.git","clone_url":"https://github.com/elasticsearch/kibana.git","svn_url":"https://github.com/elasticsearch/kibana","homepage":"http://www.elasticsearch.org/overview/kibana/","size":61671,"stargazers_count":2992,"watchers_count":2992,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1160,"mirror_url":null,"open_issues_count":330,"forks":1160,"open_issues":330,"watchers":2992,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961"},"html":{"href":"https://github.com/elasticsearch/kibana/pull/2961"},"issue":{"href":"https://api.github.com/repos/elasticsearch/kibana/issues/2961"},"comments":{"href":"https://api.github.com/repos/elasticsearch/kibana/issues/2961/comments"},"review_comments":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961/comments"},"review_comment":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/elasticsearch/kibana/pulls/2961/commits"},"statuses":{"href":"https://api.github.com/repos/elasticsearch/kibana/statuses/fce76c4c1f3987a1ed3ba8025eb96f8b405287ae"}}}}