You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/getting-started/pages/look-at-the-results.adoc
+56-11Lines changed: 56 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
= Explore the Server Configuration
2
2
:page-pagination:
3
3
:imagesdir: ../assets/images
4
-
:description: Once you have Couchbase Server running, you can log into the Couchbase Server Web Console, and start to examine the different features that it provides.
4
+
:description: Once you have Couchbase Server running, you can log into the Couchbase Server Web Console and start to examine the different features that it provides.
5
5
6
6
[abstract]
7
7
{description}
@@ -23,29 +23,31 @@ The Docker image that you installed comes pre-configured with a default username
23
23
24
24
Type these credentials into the appropriate fields and click btn:[Sign In].
25
25
26
+
[#examine-the-cluster-dashboard]
26
27
== Examine the Cluster Dashboard
27
28
28
29
Every time you log into the Web Console, you are brought to the [.ui]*Cluster Dashboard*:
The [.ui]*Cluster Dashboard* provides a graphical summary of the current state of your Couchbase cluster.
34
+
The [.ui]*Cluster Dashboard* provides a graphical summary of the Couchbase cluster's current state.
34
35
The term _cluster_ might seem unexpected at this point, since you are only running a single instance of Couchbase Server; but nevertheless, it counts as a cluster of one.
35
36
36
-
All of the values that are displayed on this screen were automatically configured by the sandbox container image during installation.
37
-
In production, you will specify these values individually according to your needs.
37
+
All the values that are displayed on this screen were automatically configured by the sandbox container image during installation.
38
+
In production, you will specify these values individually, according to your needs.
38
39
39
40
Notice the information panel at the very bottom.
40
41
This shows that you have a single active bucket on the system — _bucket_ meaning a logical group of data-items.
41
-
Taking a closer look at this bucket will give you some idea of how Couchbase stores data, and prepare you to make your first data-queries.
42
+
Taking a closer look at this bucket will give you some idea
43
+
of how Couchbase stores data and prepares you to make your first data-queries.
42
44
43
45
== Examine Your Bucket and Its Documents
44
46
45
47
Click menu:Buckets[] in the left-hand navigation bar to bring up the [.ui]*Buckets* screen.
46
48
47
49
The [.ui]*Buckets* screen shows that you have a single active bucket on the system (_bucket_ meaning a logical group of data-items).
48
-
Taking a closer look at this bucket will give you some idea of how Couchbase stores data, and prepare you to make your first data-queries:
50
+
Taking a closer look at this bucket will give you some idea of how Couchbase stores data and prepare you to make your first data-queries:
The [.ui]*Scopes and Collections* screen shows, in a succession of page-views, the scopes that are contained within the bucket.
62
-
To see the collections that are contained within a given scope, left-click on the row for the scope -- for example, for the `inventory` scope:
64
+
To see the collections that are contained within a given scope,
65
+
left-click on the row for the scope, e.g., for the `inventory` scope:
63
66
64
67
[#travel_sample_collections_screen]
65
68
image::travelSampleCollectionsScreen.png["The travel-sample Scopes screen, showing the inventory collections",720]
66
69
67
70
In Couchbase Server 7.0 and later, all documents must be contained in a scope and collection.
68
71
If you import a dataset that was created in earlier versions of Couchbase Server, the documents are automatically saved within a `_default` scope and a `_default` collection.
69
72
For your initial work with the system, this will be fine.
70
-
But as you continue, and you create more documents, your will benefit from using scopes and collections to organize those documents in the best way: this will make data-access intuitive and clear.
73
+
But as you continue, and you create more documents, you will benefit from using scopes and collections to organize those documents in the best way: this will make data-access intuitive and clear.
71
74
72
75
See the xref:getting-started:/look-at-the-results.adoc#other-destinations[Other Destinations] section, below, for a link to information on creating and managing your own scopes and collections.
73
76
@@ -84,7 +87,7 @@ The following document retrieval controls are provided:
84
87
The documents within the selected collection are those that will be retrieved.
85
88
(For information on scopes and collections, see xref:learn:data/scopes-and-collections.adoc[Scopes and Collections]).
86
89
* *Limit*: The maximum number of rows (documents) to retrieve and display at once.
87
-
* *Offset*: The number of documents in the entire set of the current collection that should be skipped, before display begins.
90
+
* *Offset*: The number of documents in the entire set of the current collection that should be skipped before displaying begins.
88
91
Notice that when you click [.ui]*Next Batch >*, the [.ui]*Offset* increases by the same value that is specified in [.ui]*Limit*.
89
92
* *Document ID*: Accepts the ID of a specific document.
90
93
Leave this field blank to retrieve documents based on *Limit* and *Offset*.
The document consists of a series of _key-value_ pairs (or, as they are sometimes expressed, _name-value_ pairs).
105
108
You can make modifications to key-values directly in this editor.
106
-
As will be demonstrated later, Couchbase Server allows you to search for keys, and return the corresponding values, by means of a _query_.
109
+
As will be demonstrated later, Couchbase Server allows you to search for keys and return the corresponding values by using a _query_.
107
110
For example, here, if you searched on the name `country`, you would return the value `United States`; if on the name `icao`, the value `MLA`.
108
111
+
109
112
If you make changes in the [.ui]*Edit Document* dialog, click [.ui]*Save* to save your changes.
110
113
If you want to create a new document based on an existing document, you can click the *Make a copy of this document* button (described next).
111
114
If you want to create an entirely new document, you can click the btn:[ADD DOCUMENT] button in the upper-right.
112
115
+
113
-
Note that Couchbase Web Console supports the editing of documents that are up to 10 MB in size (although documents on Couchbase Server can be up to 20 MB in size).
116
+
Note that Couchbase Web Console supports the editing of documents that are up to 10 MB in size, (although documents on Couchbase Server can be up to 20 MB in size).
114
117
115
118
* *Make a copy of this document*: Click this button to bring up the [.ui]*Save As* dialog, which allows you to create a new document based on the existing one:
116
119
+
@@ -127,6 +130,48 @@ Click it to save your changes to the document.
127
130
128
131
To view successive sets of documents, use the [.ui]*Next Batch >* and [.ui]*< Prev Batch* buttons.
129
132
133
+
[#examining-the-cluster-logs]
134
+
== Examining the Cluster's Logs
135
+
136
+
The Couchbase Server maintains a constant, configurable log of alerts and operations,
137
+
a subset of which can be examined from the web console.
138
+
139
+
Start by selecting menu:Logs[] from the left-hand navigation menu.
140
+
141
+
image::eventLogging.png[]
142
+
143
+
You will be presented with a screen containing a series of events logged by the cluster.
144
+
145
+
You can filter the log entries by entering a string in the [.ui]*filter logs ...* field.
146
+
147
+
You can also opt to have logging data written to a file or a bucket on a Couchbase node
148
+
by selecting the menu:Collect Information[] option from the top menu:
149
+
150
+
image::collectLogInformationOptions.png[]
151
+
152
+
The [.ui]*Collection Information* screen will be displayed, giving you a number of options for collecting logs.
153
+
As well as specifying the nodes logged, you can also specify a location for writing the logging data.
154
+
155
+
Once the options have been set, click on btn:[Start Collecting] to start recording logs to your specified location.
156
+
157
+
TIP: If you are having a problem with your cluster setup, it may be useful to provide Couchbase Support with a log of the server activity.
158
+
159
+
[#examining-the-cluster-metrics]
160
+
== Examining the Cluster's Metrics
161
+
162
+
As well as examining the state of the cluster from the web console, (see the section on xref:examine-the-cluster-dashboard[Examining the cluster dashboard]),
163
+
you can monitor more specific elements of the cluster operation, such as the indexes in real-time:
164
+
165
+
166
+
. Select [.ui]*All Services* from the menu:Choose Dashboard[] dropdown menu.
167
+
. The page will expand to include all the services available on the node.
168
+
Click on [.ui]*Index* and you will be presented with a series of graphs depicting real-time metrics for the indexes running on the node.
169
+
+
170
+
image::showDashboardIndex.png["Index from UI dashboard", 720]
171
+
+
172
+
TIP: The graphs will allow you to see if loads across multiple nodes differ significantly.
0 commit comments