metrics API methods