Application Real-Time Monitoring Service:Browser Monitoring FAQ

Billing-related FAQ

• How do I stop billing?

• How do I set consumption limits?

• How do I configure quota alerts for resource plans?

Usage-related FAQ

• Why do the names of some monitored pages or APIs contain asterisks (*)?

• Why is the PV list different from the page speed list?

• No trace ID is found in the API logs, and as a result, the page fails to be redirected to the application monitoring page. Why does this happen?

• Why is the Source Map file error displayed when I am troubleshooting JavaScript (JS) errors?

• What are the differences between console settings and the setConfig method?

• How do I configure the environment and version in an SDK?

• How do I view the version number of a configuration?

• How do I view the TP of a user for a page?

• What do I do if the ARMS configuration does not take effect?

• Why are JS errors on mini programs not reported?

• Can JS errors returned by the console.error method be listened to?

• In the Weex environment, why does a UID set for a mini program not take effect?

• How long can logs be stored?

• After I activate ARMS Pro Edition, can I continue to use the sites that are created during the trial period?

• Why are the PVs on the same page different among modules in the ARMS console?

• Why is the value of the duration parameter smaller than that of the connect download parameter?

• What do I do if I am not sure whether the SDK has been loaded when I call the __bl.performance() method?

• How do I resolve script errors?

Why do some monitored URLs or APIs contain asterisks (*)?

The page statistics of Browser Monitoring are retrieved based on actual page URLs and calculated by dimension. The asterisks (*) in the names of monitored pages or APIs are not a part of the page URLs. The asterisks (*) indicate the result of URL convergence. Therefore, a name that contains an asterisk (*) is not a specific URL, but a group of similar URLs.

How URL convergence works

• Problem: Variables make it difficult to monitor or analyze similar URLs.

• Objective: Group similar URLs by replacing variables with asterisks (*).

• Solution: Use the proprietary URL convergence algorithm of Alibaba Cloud to group similar URLs and decrease the number of URLs. This way, you can keep as much semantic information as possible and decrease the number of URLs. This is completed in the following two steps:

  • Aggregation: Aggregate similar URLs into one group.

  • Variable identification: Extract the variables from the URLs in the same group, and replace the variables with asterisks (*).

The following figure shows the URL convergence process.

Solution

For information about how to disable URL convergence, see urlHelper.

[Back to Top]

Why is the PV list different from the page speed list?

This is because your application is a single-page application (SPA), and the SPA auto-resolution feature is enabled. In SPA scenarios, page views (PVs) and the page speed are measured by using the following methods:

• PVs: When a hashchange event is triggered, the PV data is automatically reported to record the PVs of the page based on the hash value. Therefore, when you view the PV list of an SPA, you can view the exact PVs of the hash pages.

• Page speed: When the hash value of an SPA changes, the page speed does not change. Therefore, the page speed is not recorded based on the hash value. This way, unnecessary reports are avoided and page performance is clear.

[Back to Top]

No trace ID is found in the API logs, and as a result, the page fails to be redirected to the application monitoring page. Why does this happen?

1. Log on to the ARMS console.
2. In the left-side navigation pane, choose Browser Monitoring > Browser Monitoring. On the Browser Monitoring page, click the name of an application.

3. In the left-side navigation pane, choose Settings > Application Settings.

4. On the Precondition tab, check whether Associate with Application Monitoring is selected for the ARMS agent configuration. If Associate with Application Monitoring is not selected, select it. Then, connect the ARMS agent to the frontend application again.

   

   Check whether the trace IDs are generated in the API logs. If no trace ID is generated, proceed to Step 5.

5. Check whether the domain name used in your page request is the same as the domain name used in your API request. If the domain name used in your page request is different from the domain name in your API request, this is cross-domain access. In this case, trace IDs fail to be generated to prevent API request failure caused by cross-domain authentication.

   For information about how to resolve this problem, see Use the front-to-back tracing feature to diagnose API errors.

[Back to Top]

Why is the Source Map file error displayed when I am troubleshooting JavaScript (JS) errors?

1. Make sure that the file suffix is .js.map.

2. Make sure that your account has the permissions to write data to ARMS. If your account does not have the write permissions, contact your administrator.

[Back to Top]

What are the differences between console settings and the setConfig method?

Console settings can accelerate only the generation of configuration code, and the generated code takes effect only after the code is published. However, modifications made by calling the setConfig method immediately take effect.

In addition, console settings are valid only when you initialize ARMS to monitor an application. When the application is being monitored by ARMS, you must call the setConfig method to modify configurations.

[Back to Top]

How do I configure the environment and version in an SDK?

You can set the release parameter to compare versions. For more information, see SDK reference. You can also set the environment parameter to distinguish different environments. For more information, see SDK reference.

• The value prod indicates a production environment.

• The value gray indicates a phased-release environment.

• The value pre indicates a staging environment.

• The value daily indicates a daily environment.

• The value local indicates a local environment.

[Back to Top]

How do I view the version number of a configuration?

1. Log on to the ARMS console.
2. In the left-side navigation pane, choose Browser Monitoring > Browser Monitoring. On the Browser Monitoring page, click the name of an application.

3. In the left-side navigation pane, choose Application > View Details.

   The version number in a log is displayed in the Version column in the Log List section.

4. You can also filter logs by environment and version in the menu bar. You can filter logs only after PV logs are set with a version number.

[Back to Top]

How do I view the TP of a user for a page?

1. Log on to the ARMS console.
2. In the left-side navigation pane, choose Browser Monitoring > Browser Monitoring. On the Browser Monitoring page, click the name of an application.
3. In the left-side navigation pane, choose Application > Session Traces.
4. In the Session List section, find the session and click its ID in the Session ID column. The Session Tracking Details page appears.

5. Move the pointer over the timeline area in the Visit Timeline column to view the time on page (TP) of a user for a page.

[Back to Top]

How do I view the custom performance metrics for Browser Monitoring?

1. Log on to the ARMS console.
2. In the left-side navigation pane, choose Browser Monitoring > Browser Monitoring. On the Browser Monitoring page, click the name of an application.

3. In the left-side navigation pane, choose Application > Page Speed.

4. Custom performance metrics are displayed in the Page Speed section.

[Back to Top]

What do I do if the ARMS configuration does not take effect?

The possible reason is that the browser cache is not updated. To resolve this issue, perform the following operations: In the left-side navigation pane of the ARMS console, choose Application > View Details. Switch to the latest version to view the trend chart. If the version number is not configured, you can set the release parameter of the ARMS SDK. For more information, see SDK reference. After the release parameter is set, check whether the value that you specified is displayed as the latest version.

[Back to Top]

Why are JS errors on mini programs not reported?

This may be because error messages are captured by the trycatch statement at the underlying layer of the mini programs in asynchronous mode, and the error messages fail to be uploaded. You can manually report error messages. For more information, see API reference.

[Back to Top]

Can JS errors returned by the console.error method be listened to?

• Yes, JS errors returned by the console.error method can be listened to. Web browsers report the error messages that meet the format requirements of JS errors.

• You can manually report error messages in the mini program. For more information, see API reference.

[Back to Top]

In the Weex environment, why does a UID set for a mini program not take effect?

• If you have not called the setConfig method, check whether you specified a UID during initialization configuration. If you did not specify a UID, specify one.

• If you have called the setConfig method, specify another UID and call the method again.

[Back to Top]

How long can logs be stored?

• ARMS Basic Edition: Logs can be stored for up to seven days.

• ARMS Pro Edition: Logs can be stored for up to 30 days.

[Back to Top]

After I activate ARMS Pro Edition, can I continue to use the sites that are created during the trial period?

• No, you cannot continue to use those sites. Within 15 days after the trial period expires, the sites are suspended due to overdue payments. You can try to restart the application.

• If ARMS Pro Edition is not activated within 15 days after the trial period expires, the sites are deleted to save your computing and storage resources. Relevant resources are released, and the data on the resources cannot be recovered.

[Back to Top]

What version numbers are used by the application edition and host edition of ARMS?

• The application edition uses the version number of the current online project. You can set the release parameter of the ARMS SDK to specify the version number of the application edition. For more information, see SDK reference.

• The host edition uses the version number of the app where the current project resides. The version number of the host edition is automatically obtained by the SDK. The version of a hosted app cannot be resolved. Only versions of Taobao, Alipay, or WeChat are resolved.

[Back to Top]

Why are the PVs on the same page different among modules in the ARMS console?

On the Page Speed page, the number of PVs is equal to the number of entries in the performance log multiplied by the sampling rate.

On the Page page under Dimensions, the number of PVs is equal to the value shown in the PV log.

Performance logs to be automatically reported are reported only after pages are loaded. A performance log is reported each time the page is refreshed.

After the SPA mode is enabled, PV logs are reported each time routes are switched. In SPA mode, the number of performance logs is smaller than the number of PV logs. This results in a large difference in the PVs for different modules.

[Back to Top]

Why is the value of the duration parameter smaller than that of the connect download parameter?

The performance data loaded to ARMS resources is obtained from the performance.getEntriesByType('resource') method. The domain name of a third-party ARMS resource must be the same as that of the site of the resource being requested. By default, the value of 0 is obtained from the performance.getEntriesByType('resource') method for the following parameters of the performance data of cross-domain resources:

redirectStart
redirectEnd
domainLookupStart
domainLookupEnd
connectStart
connectEnd
secureConnectionStart
requestStart
responseStart

Some time properties may be inaccurate or abnormal because the preceding parameters are used in the calculation. For example, in connect download:responseEnd - responseStart, the value of the duration parameter is smaller than that of the connect download parameter because the timestamp specified by the responseStart parameter is 0.

• To resolve this issue, for self-managed CDN resources, you can configure the response header Timing-Allow-Origin to specify the time allowed to obtain the resources.

• For third-party resources, we recommend that you use the value of the duration parameter as the major reference.

[Back to Top]

What do I do if I am not sure whether the SDK has been loaded when I call the __bl.performance() method?

For more information, see Page data reporting of SPAs.

[Back to Top]