code: @SuppressWarnings("unused")
    final void startRecording() {
      if (firstTime) {
        Object obj;
        doStartRecording();
        obj = new Object();
        AllocationStats stats = stopRecording(1);
        if (stats.getAllocationCount() != 1 || stats.getAllocationSize() < 1) {
          throw new IllegalStateException(
              String.format("The allocation recording infrastructure appears to be broken. "
                  + "Expected to find exactly one allocation of a java/lang/Object instead found %s",
                  stats));
        }
        firstTime = false;
      }
      doStartRecording();
    }
docs: Clears the prior state and starts a new recording.  Supressing warnings on object created
  that is not used.
  
  @throws IllegalStateException if the recording infrastructure is misconfigured.