What is an OpenSearch mapping?
To understand OpenSearch Mappings you can read the article here.
How can I view the current mappings?
There are two ways you can view the current mappings on your Logit.io Stacks.
Using OpenSearch Dashboards Dev Tools
One way is to use dev tools in OpenSearch Dashboards. You can access OpenSearch Dashboards for any stack by choosing Launch Logs from your dashboard.
Once OpenSearch has opened you need to choose Dev Tools in the left-hand menu.
In the console section of the screen, we are going to enter the following command.
You should get an output similar to that of the screenshot below. Here you can see all the mappings currently used on the OpenSearch server.
Using OpenSearch Dev Tools to retrieve the mappings of a specific index name
You can also search for a specific mapping of an Index name. For example, if we wanted to see the mappings for a Filebeat index name we can run the following to return only the desired mappings.
You can also search for the specific mappings of an index name. First, we will get the names of our indices and then secondly we will use index name to view the indices mappings.
First, run the following;
This should give an output similar to the below screenshot:
From here we can then choose an index-name from the third column of information. For this example, I have chosen the index-name filebeat-2019.05.17.
We can now use this to get the mappings by running the following command in OpenSearch Deb Tools.
This will give an output similar to the screenshot below:
Using the Mapping API
The second way to review the mappings currently in use is to use the mapping API. To do this you will need your OpenSearch endpoint address and your ApiKey. These can be accessed from your dashboard by choosing
Settings > OpenSearch Settings.
The next step is to write a curl -x get command to retrieve the mappings from OpenSearch.
curl -X GET your-elasticsearch-endpoint-address-es.logit.io/_all/_mapping?your-api-key&pretty
You will be returned with a JSON output similar to the below screenshot.
Using the Mapping API to retrieve the mappings of a specific index name
Similar to OpenSearch Dev Tools you can also use the Mapping API to retrieve the mappings of a specific index-name.
To do so you will need to know the name of the index, so first we need to retrieve the names of our indices by running the following command.
curl -X GET your-elasticsearch-endpoint-address-es.logit.io/_cat/indices?your-api-key&pretty
Once the command has been run you will get an output similar to the screenshot below:
Now we can select the index-name from the third column of information and use it to retrieve the mappings. So again in the below example, I have used the index-name of filebeat-2019.05.17.
curl -X GET your-elasticsearch-endpoint-address-es.logit.io/filebeat-2019.05.17/_mapping?your-api-key&pretty
This will return an output similar to that of the below screenshot: