Frequently asked questions

General

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

A: AppMap is open-source software (OSS), free for personal and commercial use under the MIT license. AppMap Cloud is a repository for AppMaps. It is commercial software. Read more about AppMap Cloud.


I am using static analysis tools and linters. What can AppMaps offer me that I don’t already have?

A: The AppMap uses both static analysis and interactive code analysis (ICA) technology. ICA records and processes dynamic execution traces of running code. Since ICA processes actual executing code, it has access to data that static analysis tools do not. Visit AppMap overview for more information.


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: No! We are always working on supporting new languages and frameworks. And, all AppMap client code, including language and framework integrations, is open source. Sign up for our Newsletter for updates and contact us on Discord to learn more or to contribute to open source development.


How can I contribute to the AppMap open source projects?

A: 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 May 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!