android-api-showcase

IBM-Instana-Demo

A demo application for understanding the features & capabilities of IBM Instana Android Agent.

Features Identified

• Runtime update of reporting URL & Instana Key: Dynamically configure the reporting URL and Instana key within the application at runtime, allowing flexibility and easy management.

• Create/Update User Data - mocking user login: Simulate user login to update user data and ensure accurate tracking of identified users. The information provided will be reflected in the identified user list.

• Update Instana configuration in runtime: Update the Instana configuration on-the-fly, including the reporting URL and key, without requiring a restart. This allows for seamless adjustments to the Instana integration.

• Make network calls based on the identified Network client: Utilize the different network clients supported by the Instana Android Agent to make network calls and monitor network performance. Test and analyze your app's behavior under various network scenarios.

• Add View functionality to identify the pages/views visited by the user: Implement view tracking to gain insights into the user's navigation patterns within the app. Monitor and analyze which pages or views are most frequently visited by users.

• Create crashes for reporting: Generate crashes and exceptions within the app to test the crash reporting feature of Instana. Explore different scenarios and ensure accurate crash reporting in the Instana dashboard.

• Test Logs with customizable log levels: Log developer-defined data with customizable log levels, allowing detailed debugging and analysis. Capture and review relevant information based on the selected log level.

• Custom events reporting: Generate and report custom events within the app. Associate custom event names with metadata to provide meaningful insights in the Instana dashboard. Track specific user actions or milestones using custom event reporting.

Note: These features are designed to showcase the capabilities of IBM Instana Android Agent and provide a comprehensive understanding of its functionality.

For more information and detailed documentation, visit the IBM Instana official website. Additionally, you can refer to the Android Agent API documentation for detailed information about the Instana Android Agent API.

🎉 Get started with IBM Instana and explore the power of real-time monitoring and analytics in your Android applications!

Screen Captures

Credentials Screen - onetime	Feature Listing Screen	User Data Screen	Network Request Screen	Instana Configuration Screen

Instana Crash Generate Screen	Generate Logs Screen	Custom Events Screen	View Test Screen1	View Test Screen2

Brief descriptions on each screens

Initial Setup Screen	This screen will be displayed to the user for the first time to set up the reporting URL and the key obtained from the dashboard. Once the user saves the data, the application class will be recreated.
Feature Listing Screen	This is the home screen where all the available features of the Android Instana Agent are showcased. The user can select any feature to test. To ensure the correct key is provided, the collected key and URL are displayed at the top.
User Data Screen	This screen displays the user's profile or user details. It simulates user login to update the identified user list based on the provided data. The info button at the top provides these details to the user.
Network Request Screen	On this page, the user can make network calls using the selected network client. The Instana Android Agent supports three clients for monitoring, which have been added for ease of testing. The user can enter a URL for a demo link or provide their own URL to be called using the custom URL option.
Instana Configuration Screen	This is the base page for updating the configuration of Instana at runtime. The user can change the reporting URL and key to report to another Instana dashboard or instance. Applying the changes requires restarting the activity.
Instana Crash Generation Screen	On this screen, the user can generate various types of exceptions and crashes. They can even generate a custom message crash for a RuntimeException and check the crash reporting in the dashboard.
Generate Logs Screen	Using this screen, the user can provide custom logs for reporting, including the desired log level. They can select the available options to create a log tag and message. For error throwables, there is an optional field available.
Custom Events Screen	On this screen, the user can create custom events with custom event names and associated metadata. These events will be shown on the dashboard along with a backend tracking ID.
View Test Screen 1 & Screen 2	These screens are used for tracking views. In the first screen, the user can provide a name, such as "Product Listing" (an example name is provided). Similarly, the second screen allows the user to update the name, for example, "Checkout Page". This enables tracking of the views visited by the user based on the provided names in the dashboard.