send priority instrumentation message on startup with version info

pkg/analyzer/lib/instrumentation/instrumentation.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library instrumentation;
 
 /**
  * A container with analysis performance constants.
  */
 class AnalysisPerformanceKind {
@@ skipping 43 matching lines @@
       new InstrumentationService(null);
 
   static const String TAG_ERROR = 'Err';
   static const String TAG_EXCEPTION = 'Ex';
   static const String TAG_FILE_READ = 'Read';
   static const String TAG_LOG_ENTRY = 'Log';
   static const String TAG_NOTIFICATION = 'Noti';
   static const String TAG_PERFORMANCE = 'Perf';
   static const String TAG_REQUEST = 'Req';
   static const String TAG_RESPONSE = 'Res';
+  static const String TAG_STARTUP = 'Startup';

[Brian Wilkerson, 2015/01/16 19:48:28]

This is what "TAG_VERSION" was added for.

[danrubel, 2015/01/20 17:23:54]

Good to know. Switched to using that instead.

   static const String TAG_VERSION = 'Ver';
 
   /**
    * The instrumentation server used to communicate with the server, or `null`
    * if instrumentation data should not be logged.
    */
   InstrumentationServer _instrumentationServer;
 
   /**
    * Initialize a newly created instrumentation service to comunicate with the
@@ skipping 97 matching lines @@
   }
 
   /**
    * Log that a response has been sent to the client.
    */
   void logResponse(String response) {
     _log(TAG_RESPONSE, response);
   }
 
   /**
+   * Signal that the client has started analysis server.
+   * This method should be invoked exactly one time.
+   */
+  void logVersion(String uuid, String clientId, String clientVersion,
+      String serverVersion, String sdkVersion) {
+
+    String normalize(String value) =>
+        value != null && value.length > 0 ? value : 'unknown';
+
+    if (_instrumentationServer != null) {
+      _instrumentationServer.logWithPriority(
+          _join(
+              [
+                  TAG_STARTUP,
+                  uuid,
+                  normalize(clientId),
+                  normalize(clientVersion),
+                  serverVersion,
+                  sdkVersion]));
+    }
+  }
+
+  /**
    * Signal that the client is done communicating with the instrumentation
    * server. This method should be invoked exactly one time and no other methods
    * should be invoked on this instance after this method has been invoked.
    */
   void shutdown() {
     if (_instrumentationServer != null) {
       _instrumentationServer.shutdown();
       _instrumentationServer = null;
     }
   }
@@ skipping 73 matching lines @@
     }
   }
 
   @override
   void shutdown() {
     for (InstrumentationServer server in _servers) {
       server.shutdown();
     }
   }
 }