Have you ever thought about the importance of a medium in the communication process? A medium, as we know, is a channel through which information is circulated between the sender and the receiver. What if the medium encounters a problem? It then becomes a barrier to an effective communication process.
Similarly, an HTTP API call acts as a medium of communication between the mobile app and the server. Failures in HTTP calls are critical as it affects the functioning of the app, which may lead to users uninstalling the app.
What could be the reasons for HTTP request failure?
Consider a scenario where your app user types all the required credentials in the login screen of your Android app and taps on the login button but nothing happens. As the page becomes unresponsive, chances are your users may uninstall your app never to return. We consider HTTP call issues as fatal issues right up there along with app crashes.
How to overcome this situation?
HTTP request failures can occur when the app sends incorrect data to the server, delayed calls, exceptions thrown during an HTTP call or even executing duplicate HTTP calls. The thing to note here is that developers need to be notified of such issues in real time.
Now the question in your mind will be, should I use a bug reporting tool to manually call functions to report HTTP request issues on every callback block? Well that is messy and time consuming.
Instead, an automated HTTP request tracking mechanism will serve the purpose.
By enabling the HTTP tracking mechanism in Appxiom SDK with a single line of code, developers will be able to monitor for failures in all okhttp based API calls originating from the application.
Java code snippet on activating HTTP tracking with Appxiom
//Current OkHttpClient code.
client = new OkHttpClient.Builder().build();
Change to,
import com.appxiom.android.appxiomcore.OkHttp3Client;
...
//Appxiom based OkHttpClient code.
client = new OkHttp3Client(new OkHttpClient.Builder()).build();
Kotlin code snippet on activating HTTP tracking with Appxiom
//Current OkHttpClient code.
var client = OkHttpClient.Builder().build()
Change to,
import com.appxiom.android.appxiomcore.OkHttp3Client
...
//Change to Appxiom based OkHttpClient code.
var client = OkHttp3Client(OkHttpClient.Builder()).build()
Please find our detailed Java and Kotlin documentation on enabling HTTP tracking with libraries like OkHttp, Retrofit and Volley.
Are the developers getting notified of HTTP issues enough?
The answer is a big No.
The next logical step is to be able to reproduce and fix them fast. In order to accomplish this, we need to have access to precise data points involved in the execution of an API call.
Appxiom SDK is capable of generating detailed bug reports with data points like complete URL, URL parameters, status code, request body and request-response headers.
But what about user sensitive data?
Making sure that privacy and security is maintained is of utmost importance especially when dealing with HTTP request monitoring. Most of the HTTP calls will have authorization tokens and other sensitive data in the header fields. The tool that is used to track HTTP requests should have a way to mask the sensitive data from the application side itself, which will prevent this data from reaching third party servers.
Appxiom provides a simple and easy to use @Observe annotation to enable filtering such sensitive data and prevent it from being sent to the Appxiom dashboard. Please find our detailed Java and Kotlin documentation.
Java code snippet on filtering sensitive header fields in request and response of an HTTP call
@Observe(maskHeaders = {"X-Key", "Accept"})
public class BlogApp extends Application {
@Override
public void onCreate() {
super.onCreate();
Ax.init(this);
}
}
Kotlin code snippet on filtering sensitive header fields in request and response of an HTTP call
@Observe(maskHeaders = {"X-Key", "Accept"})
class BlogApp: Application() {
override fun onCreate() {
super.onCreate()
Ax.init(this)
}
}
Apart from these, data points like device and device state data along with activity trail will also be included with every issue report.
Appxiom is capable of detecting HTTP request issues in iOS and watchOS apps. Apart from this, SDK is capable of detecting and reporting crashes, frame rate issues, ANR, function failures, feature failures, memory leaks, abnormal memory usage, exceptions and custom issues. Appxiom is available for Android as Java & Kotlin SDK, iOS as Objective- C & Swift Framework and watchOS as Objective-C & Swift Framework.
Visit appxiom.com to learn more about Appxiom. Detailed documentation is available at docs.appxiom.com.
