AppMap Browser Extension

• AppMap Browser Extension
  • About
  • How it works
    • 1. Install the AppMap browser extension
    • 2. Enable AppMap remote recording for your project
    • 3. Record AppMap
    • 4. View the AppMap
  • GitHub repository

About

AppMap remote recording is an easy way to record AppMaps and analyze end-user flows for applications with a web-based UI. Remote recording with the AppMap browser extension is composed of three parts:

• The AppMap agent for your programming language, which runs on the server side and makes the actual recordings of the code
• A browser extension which is used to start and finish recordings
• The AppMap server which is used for storing and visualization of AppMaps recorded with the browser extension.

Note: An AppMap account is required for recording AppMaps with the browser extension. If you do not plan on using the AppMap server for advanced AppMap management, we recommend that you use the AppMap code editor extensions for recording and saving AppMap files locally.

How it works

This guide assumes that you have the AppMap agent installed and running with your application server code. By following the steps shown here, you will install the browser extension and use it to create, upload and view an AppMap.

1. Install the AppMap browser extension

1. Install the AppMap browser extension for either Chrome or Firefox

2. You will now see the AppMap logo displayed in your extensions area.

2. Enable AppMap remote recording for your project

• Remote recording - Ruby
• Remote recording - Python
• Remote recording - Java
• Remote recording - JavaScript

3. Record AppMap

Creating a recording is easy.

1. Click on the AppMap icon next to the search bar in the head of your browser. This will open a small window.
2. Push the red round button to start recording.
3. Use your application as you normally would. Go through an end-user flow that you would like to analyze. As you click around and visit pages in your application, the AppMap agent records what is happening on the back end.
4. When you are finished using your app, open the AppMap browser extension again. Push the red square button to stop recording.
5. The recorded AppMap will be uploaded to the AppMap server. A new browser tab will open to your account and display the AppMap.

4. View the AppMap

When you stop recording, your AppMap will open in a new browser tab automatically. This may take a minute to render depending on the size of the recording you made. To make it easier to revisit your AppMap, you may want to give it a descriptive name. You can also make the AppMap public, so anyone with the link can view it.

GitHub repository

https://github.com/getappmap/appland-browser-extension

---