Merge branch 'master' of https://github.com/wavefrontHQ/docs into mst…

…aneva-doc-fixes
wavefrontHQ · Sep 29, 2023 · f4d4be6 · f4d4be6
2 parents 93d363d + 5ec1d24
commit f4d4be6
Show file tree

Hide file tree

Showing 24 changed files with 565 additions and 18 deletions.
diff --git a/images/app_monitoring_logging_grid_view_to_logs.png b/images/app_monitoring_logging_grid_view_to_logs.png
diff --git a/images/app_monitoring_logging_table_view_to_logs.png b/images/app_monitoring_logging_table_view_to_logs.png
diff --git a/images/app_monitoring_trace_table_view_create_alert.png b/images/app_monitoring_trace_table_view_create_alert.png
diff --git a/images/app_monitoring_traces_browser.png b/images/app_monitoring_traces_browser.png
diff --git a/images/app_monitoring_tracing_grid_view_create_alert.png b/images/app_monitoring_tracing_grid_view_create_alert.png
diff --git a/images/application_monitoring_ebpf_service_map.png b/images/application_monitoring_ebpf_service_map.png
diff --git a/images/application_monitoring_grid_view.png b/images/application_monitoring_grid_view.png
diff --git a/images/application_monitoring_table_view.png b/images/application_monitoring_table_view.png
diff --git a/images/monitor_applications_onboarding.png b/images/monitor_applications_onboarding.png
diff --git a/images/service_map_add_services.png b/images/service_map_add_services.png
diff --git a/images/service_map_focus_on_a_service.png b/images/service_map_focus_on_a_service.png
diff --git a/images/service_map_tracing_traffic.png b/images/service_map_tracing_traffic.png
diff --git a/images/tracing_application_map_settings.png b/images/tracing_application_map_settings.png
diff --git a/pages/doc/application_monitoring_overview.md b/pages/doc/application_monitoring_overview.md
@@ -0,0 +1,73 @@
+---
+title: Monitor Your Applications (Controlled Release)
+tags: [applications, ebpf, traces]
+sidebar: doc_sidebar
+permalink: application_monitoring_overview.html
+summary: Learn how you can monitor your application using eBPF or tracing.
+---
+
+{% include important.html content="This feature is enabled only for selected customers. To participate, contact your account representative or [technical support](wavefront_support_feedback.html#support)."%}
+
+You can auto-discover and monitor your applications that run on a Kubernetes cluster or monitor your applications and services through the traces and spans sent to our service. 
+
+## Select How You Send Data
+
+You can explore the demo data and drill down to the service map, and other dashboards. Then, you must select how you want to send data to our service based on where the application runs or how you have configured your application. Follow these steps:
+
+<table style="width: 100%;">
+<tbody>
+    <tr>
+    <td width="40%">
+        <ol>
+            <li>
+                Click <b>View Onboarding Instructions</b>.
+            </li>
+            <li> 
+                Select how you send data to our service. For example, select <b>Applications Running on Kubernetes</b>, if you are sending data via eBPF.
+            </li>
+            <li>
+                Click <b>Save and Go To Services and Applications Page</b>.
+            </li>
+        </ol>
+      </td>
+    <td width="60%">
+        <img src="/images/monitor_applications_onboarding.png" alt="A screenshot of the annotated applications onboarding screen."/>
+    </td>
+  </tr>
+</tbody>
+</table> 
+
+## Monitor Applications Running on Kubernetes
+
+Send data via eBPF from your applications running on Kubernetes. We can then auto-discover all the services in your Kubernetes cluster.
+
+Go to [Kubernetes App Auto-Instrumentation via Pixie](https://github.com/wavefrontHQ/observability-for-kubernetes/tree/main/operator/hack/autoinstrumentation#kubernetes-app-auto-instrumentation-via-pixie), and follow the instructions to send data and start monitoring your applications.
+
+You can use the different dashboards and monitor your applications. You can:
+
+* View the services on the [Services and Applications page](service_and_application_view.html).
+* See how a specific service communicates with the other services using the [Service Map](service_map.html).
+* Identify potential hotspots using the [Service Dashboard](tracing_service_dashboard.html). 
+* Create charts using the RED metrics. 
+
+Example: See how a specific service communicates with other services in the application on the service map.
+
+![Shows a screenshot of the service map.](images/application_monitoring_ebpf_service_map.png)
+
+## Monitor Applications Using OpenTelemetry
+
+Instrument your applications that use OpenTelemetry and send traces and spans to our service.
+* [Get an overview](https://docs.wavefront.com/opentelemetry_overview.html) of how to configure your applications that use OpenTelemetry and send data to our service. 
+* The [Java tutorial](opentelemetry_java_app_tutorial.html) shows you how to auto-instrument your Java application using the OpenTelemetry Java agent and send data to our service.
+
+Once the data is in our service, you can monitor your applications and visualize the data. You can:
+
+* View the services on the [Services and Applications page](service_and_application_view.html).
+* See how a specific service communicates with the other services using the [Service Map](service_map.html).
+* Identify potential hotspots using the [Service Dashboard](tracing_service_dashboard.html).
+* Create charts using the RED metrics.
+* View the traces and spans on the [Traces Browser](/tracing_traces_browser.html).
+* Download the traces locally and view them later using [Offline Traces](tracing_view_offline_traces.html).
+
+Example: View the traces and spans on the Traces Browser, and identify the spans that take a long time to complete.
+![A screenshot of the traces browser that shows the traces.](images/app_monitoring_traces_browser.png)
diff --git a/pages/doc/application_monitoring_service_map.md b/pages/doc/application_monitoring_service_map.md
@@ -0,0 +1,167 @@
+---
+title: Service Map (Controlled Release)
+keywords: data, distributed tracing
+tags: [tracing]
+sidebar: doc_sidebar
+permalink: service_map.html
+summary: Understand how a specific service communicates with the other services in the application.
+---
+
+{% include important.html content="This feature is enabled only for selected customers. To participate, contact your account representative or [technical support](wavefront_support_feedback.html#support)."%}
+
+When you troubleshoot an application, you might need an overview of how a service communicates with the other services. The Service map helps you visualize this information.
+
+{% include note.html content="If you are using eBPF, you don't send traces to our service. Therefore, you don't see the option to drill down to the Traces Browser." %}
+
+## Service Map Features
+
+The service map lets you focus on a specific service, view Request, Error, and Duration (RED) metrics for each service, and the tracing traffic for that service. You can also drill down to the Service Dashboard and Traces Browser.
+
+To open the service map:
+1. Log in to your service instance.
+1. From the toolbar, select **Applications** > **Service and Applications**.
+    1. Table view: Click **Service Map** for a specific service.
+    1. Grid view: Click **Actions** > **View Service Map** for a specific service.
+
+Let's walk through the following scenario and get a quick overview of the service map.
+
+### Add More Services
+
+<table style="width: 100%;">
+<tbody>
+  <tr>
+    <td width="55%">
+      Next to <b>Operation</b>, click the drop-down menu, select the service you want to see on the map, and click <b>Search</b>.<br/>
+
+      You can refine your search by applying one or more filters, such as the cluster, shard, or span.kind.
+
+      <br/><br/>You see the data that match your search filters and the nearest neighboring service. For example, if you filter for the beachshirts application's styling service, you only see the services that directly communicate with the styling service.
+
+      </td>
+    <td width="45%"><img src="/images/service_map_add_services.png" alt="Search for the beachshirts application using tags"/>
+    <a name="appmap"></a>
+    </td>
+  </tr>
+</tbody>
+</table>
+
+### Update the Legend
+
+<table style="width: 100%;">
+<tbody>
+  <tr>
+    <td>
+      Click the settings icon and select Apdex, Error, or Duration. These settings can be configured by each user.
+      <ul>
+        <li>
+          Error Percentage: Update the legend to highlight the data based on the error percentage. Select <b>Error 	&#37;</b> from the drop-down and customize the values. The values need to be in ascending order.
+        </li>
+        <li>
+          Duration: Update the legend to highlight the data based on the duration. Select <b>Duration</b> from the drop-down menu and customize the values. The values need to be in ascending order and in milliseconds.
+        </li>
+        <li>
+          Apdex: Update the legend to highlight the data based on the Apdex score. Select <b>Apdex</b> from the drop-down menu. Only Super Admin users and users with the <a href="permissions_overview.html"><strong>Applications</strong> permission</a> can configure the threshold (T).
+        </li>
+      </ul>
+    </td>
+    <td markdown="span">
+      ![Shows the settings to update the legend for the error %. You need to select error % from the drop down and then add the values in ascending order.](images/tracing_legend_settings_app_map.png)
+    </td>
+  </tr>
+</tbody>
+</table>
+
+### Customize the Service Map View
+
+<table style="width: 100%;">
+<tbody>
+  <tr>
+    <td>
+      Click the settings icon to customize how you see the services on the service map.
+      <ul>
+        <li>
+          <b>Service layout</b>: Select to view the services in the default, concentric, circle, or grid layout. Choose the layout that helps you understand how your services are linked.
+        </li>
+        <li>
+          <b>Show Isolated Services</b>: Enable this option to see the services that don't interact with any other services or applications.
+        </li>
+        <li>
+          <b>Show External Service</b>: Enable this option to see the external applications or services, such as AWS services or Database services, your application communicates with. You can group these services too.
+        </li>
+          <ul>
+            <li>
+              <b>Group External Services</b>: Select this option if you want to group services. For example, group all the database services and view it as a single external service.
+            </li>
+          </ul>
+        <li><b>Show Service Labels</b>: When you have many services in an application, the service names on the service map look cluttered. To get a clear view of your application and services, disable the <b>Show Service Labels</b> option or select <b>Fade Labels on Zoom</b>. </li>
+          <ul>
+            <li>
+              <b>Fade Labels on Zoom</b>: Hides the labels of small services and gradually exposes them as you zoom in on the service map. You always see the labels of the services in red, based on the legend settings you select.
+            </li>
+            <li>
+              <b>Show Node Counts</b>: Shows the number of instances of a service running in an application. For example, <b>shopping (5)</b> shows you that there are five instances of the shopping service in the beachshirts application.
+            </li>
+          </ul>
+          <li>
+            <b>Alert Settings</b>: Select the severity of the alert you want to see on the service map. For example, if you select <b>Severe</b>, you see the alerts that have the severity status set to severe marked with a red dot on the service map.
+          </li>
+      </ul>
+      </td>
+    <td>
+      <img src="images/tracing_application_map_settings.png" alt="screenshot of the service map settings. The settings are explained on the left side."/>
+    </td>
+  </tr>
+</tbody>
+</table>
+
+
+### See Service Specific Information
+
+<table style="width: 100%;">
+<tbody>
+    <tr>
+    <td>
+      Click on the styling service. Now, you can:
+        <ul>
+          <li>View Request, Error, and Duration (RED) metrics of the specific service.</li>
+          <li>See how the service is performing using the Apdex score.</li>
+          <li> View how a specific service communicates with the other services in an application by clicking the <b>Focus</b> icon.</li>
+          <li> Navigate to the Traces Browser by clicking <b>View Traces</b>. You don't see this option if you are using eBPF.</li>
+          <li>Click <b>Actions</b> to:</li>
+          <ul>
+            <li> Navigate to the Traces Browser by clicking <b>View Traces</b>. You don't see this option if you are using eBPF.</li>
+            <li> Navigate to the Operation Dashboard by clicking <b>View Operation Dashboard</b>.</li>
+            <li> Navigate to the Service Dashboard by clicking <b>View Service Dashboard</b>.</li>
+            <li> Navigate to the Logs Browser by clicking <b>View Logs</b>.</li>
+            <li>Click <b>Create Alerts</b> to create smart alerts that filter noise and capture true anomalies. See <a href="service_and_application_view.html#create-alerts">Create an alert</a>.</li>
+            <li>If an alert you created is firing, you can see a red dot with a number on the service. The number indicates how many alerts are firing for a specific service. To see the alerts, click <b>view alerts</b>.</li>
+            <li>Configure the apdex settings by clicking the Edit icon next to the Apdex score.</li>
+          </ul>
+        </ul>
+      </td>
+    <td><img src="/images/service_map_focus_on_a_service.png" alt="Popup when you click on a service"/></td>
+  </tr>
+</tbody>
+</table>
+
+### See Service Traffic Information
+
+<table style="width: 100%;">
+<tbody>
+    <tr>
+    <td>
+      When you click on the service traffic between the styling and printing service, you can:
+        <ul><li>View Request, Error, and Duration (RED) metrics for the specific edge.</li>
+        <li> Navigate to the Traces Browser by clicking <b>View Traces for This Traffic</b>. You don't see this option if you are using eBPF.</li>
+        <li> Navigate to the Operation Dashboard to view RED metrics of the outbound and inbound operations by clicking <b>View Passenger Dashboard (Outbound Traffic)</b> or <b>View Trip Dashboard (Inbound Traffic)</b>.</li>
+        </ul>
+      </td>
+    <td><img src="/images/service_map_tracing_traffic.png" alt="The pop up when you click a tracing traffic that is bidirectional"/></td>
+  </tr>
+</tbody>
+</table>
+
+## Learn More!
+
+* [Learn how you can monitor your application using eBPF or tracing](application_monitoring_overview.html).
+* View the services on the [Services and Applications page](service_and_application_view.html).
diff --git a/pages/doc/csp_getting_started.md b/pages/doc/csp_getting_started.md
@@ -5,10 +5,12 @@ sidebar: doc_sidebar
 permalink: csp_getting_started.html
 summary: Learn the basics for administering your service on the VMware Cloud services platform.
 ---
-Starting July 3, 2023, VMware Aria Operations for Applications is a service on the VMware Cloud services platform.
+Starting July 3, 2023, VMware Aria Operations for Applications is a service on the VMware Cloud services platform. 
 
 {% include note.html content="After July 3, 2023, we support two types of subscriptions: Operations for Applications subscriptions **onboarded** to VMware Cloud services and **original** subscriptions. Original subscriptions are the existing ones and they remain as is until they migrate to VMware Cloud services. We are in the process of incrementally migrating original subscriptions to VMware Cloud services. For information about original and VMware Cloud services subscriptions and the differences between them, see [Subscription Types](subscriptions-differences.html). "%}
 
+{% include note.html content="Starting September 20, 2023, all [**new trial**](start_trial.html) instances of Operations for Applications are **onboarded** to VMware Cloud services."%}
+
 VMware Cloud services provides features to your Operations for Applications environment, such as:
 - Single sign-on (SSO) with VMware Cloud services accounts.
 - SAML 2.0 SSO identity federation with your enterprise identity provider.

diff --git a/pages/doc/csp_subscription_types.md b/pages/doc/csp_subscription_types.md
@@ -11,7 +11,9 @@ Operations for Applications subscriptions are two types: VMware Cloud services s
 
 ## Why the Two Subscription Types Differ?
 
-Starting July 3, 2023, VMware Aria Operations for Applications is a service on the VMware Cloud services platform. After this date, we support two types of subscriptions: Operations for Applications subscriptions **onboarded** to the [VMware Cloud services platform](https://console.cloud.vmware.com/) and **original** subscriptions. Original subscriptions are the existing ones and they remain as is until they migrate to VMware Cloud services. 
+Starting July 3, 2023, VMware Aria Operations for Applications is a service on the VMware Cloud services platform. After this date, we support two types of subscriptions: Operations for Applications subscriptions **onboarded** to the [VMware Cloud services platform](https://console.cloud.vmware.com/) and **original** subscriptions. Original subscriptions are the existing ones and they remain as is until they migrate to VMware Cloud services.
+
+Starting September 20, 2023, all [**new trial**](start_trial.html) instances of Operations for Applications are **onboarded** to VMware Cloud services.
 
 {% include note.html content="We will support both **original** and **onboarded** subscriptions until all **original** subscriptions are migrated to VMware Cloud services." %}
 

diff --git a/pages/doc/monitoring_wavefront_proxy.md b/pages/doc/monitoring_wavefront_proxy.md
@@ -13,7 +13,7 @@ VMware Aria Operations for Applications (formerly known as Tanzu Observability b
 
 {% include note.html content="To access the Proxies Browser, you must have the [**Proxies** permission](permissions_overview.html)." %}
 
-### Get Started wih the Proxies Browser
+### Get Started with the Proxies Browser
 
 With the Proxies Browser you can examine the status and the details of each proxy.
 
@@ -149,7 +149,7 @@ The proxy statistics are shown in a tabular chart at the end of the section:
 
 ### Proxy Troubleshooting
 
-In this section of the **Operations for Applications Service and Proxy Data** dashboard, you can investigate second-level metrics that give you insight into questions, suchh as:
+In this section of the **Operations for Applications Service and Proxy Data** dashboard, you can investigate second-level metrics that give you insight into questions, such as:
 * Why are some points blocked?
 * What's the file descriptor usage on the proxy JVM?
 * How long does it take for points to be pushed from the proxy to Operations for Applications?

diff --git a/pages/doc/purchase-additional-capacity.md b/pages/doc/purchase-additional-capacity.md
@@ -8,12 +8,12 @@ summary: Learn how to add capacity to your current VMware Aria Operations for Ap
 ---
 
 {% include note.html content="Starting July 3, 2023, VMware Aria Operations for Applications is a service on the VMware Cloud services platform. For information about VMware Cloud services subscriptions and original subscriptions and the differences between them, see [Subscription Types](subscriptions-differences.html).<br/>
-- For VMware Cloud services subscriptions, users with the VMware Cloud **Organization Owner** role can request more PPS capacity to be added to your active Operations for Applications subscription.<br/>
-- For original Operations for Applications subscriptions, **Super Admin** users with Super Admin mode enabled can request more PPS capacity to be added to your active Operations for Applications subscription. "%}
+- For VMware Cloud services subscriptions, to purchase additional capacity, you must hold the [**Organization Owner** role](csp_getting_started.html#whats-a-vmware-cloud-organization-role) in the VMware Cloud organization running the service as well as at least one [Operations for Applications service role](csp_users_roles.html#operations-for-applications-service-roles-built-in) for the service instance. If your enterprise domain is federated, to access the organization billing account, you must have a VMware account linked to your corporate account.<br/>
+- For original Operations for Applications subscriptions, to purchase additional capacity, you must be a **Super Admin** user."%}
 
 ## Supported Contracts
 
-{% include note.html content="Currently, you can buy additional capacity only if you have a billable commit contract and your Operations for Applications service is connected to a VMware Cloud Services organization. If your Operations for Applications service is not connected to a VMware Cloud Services organization, or if you have a burndown commit contract, contact the Operations for Applications sales team to add more capacity to your subscription." %}
+Currently, you can buy additional capacity only if you have a billable commit contract and your Operations for Applications service is connected to a VMware Cloud Services organization. If your Operations for Applications service is not connected to a VMware Cloud Services organization, or if you have a burndown commit contract, contact the Operations for Applications sales team to add more capacity to your subscription.
 
 ## How to Purchase Additional Capacity
 

diff --git a/pages/doc/query_language_metadata_functions.md b/pages/doc/query_language_metadata_functions.md
@@ -102,7 +102,7 @@ taggify(<expression>, <newPointTagKey>, "<newPointTagValue>")
 For example, to add a point tag `Physical location`, `Site B` use:
 
 ```
-taggify("vsphere.host.cpu.used.summation" and source="esxi-11", "Physical location", "Site B")
+taggify(ts("vsphere.host.cpu.used.summation" and source="esxi-11"), "Physical location", "Site B")
 ```
 
 ![Output has table column header Physical location and column values Site B](images/taggify-site.jpeg)