Frequently asked questions

General

Is AppMap free? Do we have to contact you about commercial use?

A: AppMap client software is open-source software (OSS). We use the MIT License.

AppMap Cloud is a repository for AppMaps. It is server-based commercial software. Read more about AppMap Cloud.


How is AppMap different from system diagrams provided by my APM?

A: APMs requre you to deploy your code before you can get information from them. AppMap works while the code is being developed - right in the code editor, and in CI/CD. Also, AppMap is focused on code behavior, design, and software architecture (data flow between web services, packages, APIs, code interfaces, SQL, caches, background jobs, etc). APMs focus on performance monitoring, error reporting, and systems architecture (network traffic between servers, load balancers, availability zones, etc).


How can I contact someone for support?

A: Join us on Discord or send email to [email protected]


My automated test coverage is not as high as I would like it to be. How can I record AppMaps?

A: There are other ways to record AppMaps besides recording automated tests. Please see the Recording methods documentation.


I want to share an AppMap with my colleagues. How?

A: You have two good options - you can share the recorded AppMap JSON file, or you can upload the AppMap to the AppMap Cloud and share a link to it. See “Add AppMaps to a code issue” for a practical guide.


How do I integrate AppMap recording in my CI/CD workflow?

A: You can record AppMaps when you run your automated tests, and then upload those AppMaps to the AppMap Cloud. Contact us for further information about the techniques and benefits of integrating AppMaps into your CI/CD.


My AppMaps are too big for practical use. Can I make them smaller?

A: Yes, AppMap recording can be optimized for more compact results. Please see Refining AppMaps.


Can I record AppMaps in a production environment?

A: Although technically possible, we recommend against instrumenting production environments. Contact us on Discord for more information.


What is the recording overhead of the AppMap clients?

A: That depends on the application platform. Ruby and Java recording clients typically introduce 10-15% processing overhead.


I do not see my language or framework supported. Am I out of luck?

A: Definitely not. We are always working on supporting new languages and frameworks. And, all AppMap client code, including language and framework integrations, is open source. Here are three ways to get more info:

  • Sign up for our Newsletter for updates. Scroll to the bottom of this page and enter your email address in the form.
  • Contact us on Discord to learn more or to contribute to open source development.
  • Check out applandinc on GitHub and you may find a new client agent for your language in development.

How can I contribute to the AppMap open source projects?

A: You can find all the AppMap open source projects on GitHub at https://github.com/applandinc/.

Please see the Community page for tips on how to get connected with the AppMap community.


Code editor extension

Which code editors and versions are supported by AppMap?

A: Visual Studio Code 1.52+, JetBrains 2021.1 and newer. See the Integrations section for details.


I do not see my code editor supported. Are you planning to support additional code editors in the future?

A: We keep adding support to new languages and code editors. Sign up for our Newsletter for updates and contact us on Discord about your specific request.


If I install and use the AppMap clients and code editor extensions, is information about my code being sent anywhere?

A: No. AppMap does not send any code or metadata about your code anywhere unless you manually upload AppMaps to the AppMap Cloud.


Code editor extensions are free today. Are you planning to charge money in the future?

A: All AppMap OSS tools and components are staying open source and free forever.


Do I need to install the language clients to view AppMaps in the code editor?

A: Language clients are only required for recording (new) AppMaps. To open pre-recorded AppMaps, you do not need to install them. You only need the AppMap file and the code editor extension.


Language clients

What languages are supported by AppMap?

A: As of July 2021, Java, Python and Ruby are officially supported


What languages are coming next?

A: JavaScript, .Net and PHP clients are in the works.


Java

What JDKs are supported?

A: JDK 8 and newer OpenJDK and Oracle distributions are supported. See the Integrations section for details.


Can I record AppMaps if I run my tests in Maven or Gradle tasks?

A: Yes! AppMap Maven and Gradle plugins make it easy to record AppMaps from tests. See the Client setup guide for details.


Ruby

What Ruby and Rails versions are supported?

A: Ruby 2.5, 2.6 and 2.7, Rails 5 and 6. See the Integrations section for details.


What Ruby test frameworks are supported?

A: RSpec, Minitest, Cucumber


Python

What Python versions are supported?

A: Python 3.6 and newer. See the Integrations section for details.


What Python frameworks are supported?

A: Django, Flask, pytest, unittest



Was this page helpful? thumb_up Yes thumb_down No
Thank you for your feedback!