SQLAlchemy: Use SQL operation and DB name as the Span name

Current instrumentation uses the entire SQL query as the operation name
which makes traces very hard to read and understand in addition to
introducing high-cardinality issues. This commit fixes the problem by
using only the SQL operation name and the DB name instead of the entire
query.

CHANGELOG.md

@@ -40,7 +40,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - `opentelemetry-instrumentation-asgi`, `opentelemetry-instrumentation-wsgi` Return `None` for `CarrierGetter` if key not found
- ([#1374](https:/open-telemetry/opentelemetry-python-contrib/pull/233))
+ ([#233](https:/open-telemetry/opentelemetry-python-contrib/pull/233))
 - `opentelemetry-instrumentation-grpc` Comply with updated spec, rework tests
  ([#236](https:/open-telemetry/opentelemetry-python-contrib/pull/236))
 - `opentelemetry-instrumentation-asgi`, `opentelemetry-instrumentation-falcon`, `opentelemetry-instrumentation-flask`, `opentelemetry-instrumentation-pyramid`, `opentelemetry-instrumentation-wsgi` Renamed `host.port` attribute to `net.host.port`
@@ -51,6 +51,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
  ([#259](https:/open-telemetry/opentelemetry-python-contrib/pull/259))
 - `opentelemetry-exporter-datadog` Fix unintentional type change of span trace flags
  ([#261](https:/open-telemetry/opentelemetry-python-contrib/pull/261))
+ ([#242](https:/open-telemetry/opentelemetry-python-contrib/pull/242)) 
+- `opentelemetry-instrumentation-sqlalchemy` Use SQL operation and DB name as span name.
+ ([#254](https:/open-telemetry/opentelemetry-python-contrib/pull/254))
 
 ## [0.16b1](https:/open-telemetry/opentelemetry-python-contrib/releases/tag/v0.16b1) - 2020-11-26
 

instrumentation/opentelemetry-instrumentation-sqlalchemy/src/opentelemetry/instrumentation/sqlalchemy/engine.py

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from sqlalchemy.event import listen
+from sqlalchemy.event import listen # pylint: disable=no-name-in-module
 
 from opentelemetry import trace
 from opentelemetry.instrumentation.sqlalchemy.version import __version__
@@ -72,22 +72,34 @@ def __init__(self, tracer, engine):
  listen(engine, "after_cursor_execute", self._after_cur_exec)
  listen(engine, "handle_error", self._handle_error)
 
+ def _operation_name(self, db_name, statement):
+ parts = []
+ if isinstance(statement, str):
+ parts.append(statement.split(" ")[0].split("\t")[0])
+ if db_name:
+ parts.append(db_name)
+ if not parts:
+ return self.vendor
+ return " ".join(parts)
+
  # pylint: disable=unused-argument
  def _before_cur_exec(self, conn, cursor, statement, *args):
+ attrs = {}
+ attrs, found = _get_attributes_from_url(conn.engine.url, attrs)
+ if not found:
+ attrs = _get_attributes_from_cursor(self.vendor, cursor, attrs)
+
+ db_name = attrs.get(_DB, "")
  self.current_span = self.tracer.start_span(
- statement, kind=trace.SpanKind.CLIENT
+ self._operation_name(db_name, statement),
+ kind=trace.SpanKind.CLIENT,
  )
  with self.tracer.use_span(self.current_span, end_on_exit=False):
  if self.current_span.is_recording():
  self.current_span.set_attribute(_STMT, statement)
  self.current_span.set_attribute("db.system", self.vendor)
-
- if not _set_attributes_from_url(
- self.current_span, conn.engine.url
- ):
- _set_attributes_from_cursor(
- self.current_span, self.vendor, cursor
- )
+ for key, value in attrs.items():
+ self.current_span.set_attribute(key, value)
 
  # pylint: disable=unused-argument
  def _after_cur_exec(self, conn, cursor, statement, *args):
@@ -108,33 +120,32 @@ def _handle_error(self, context):
  self.current_span.end()
 
 
-def _set_attributes_from_url(span: trace.Span, url):
+def _get_attributes_from_url(url, attrs):
  """Set connection tags from the url. return true if successful."""
- if span.is_recording():
- if url.host:
- span.set_attribute(_HOST, url.host)
- if url.port:
- span.set_attribute(_PORT, url.port)
- if url.database:
- span.set_attribute(_DB, url.database)
- if url.username:
- span.set_attribute(_USER, url.username)
-
- return bool(url.host)
-
-
-def _set_attributes_from_cursor(span: trace.Span, vendor, cursor):
+ attrs = attrs or {}
+ if url.host:
+ attrs[_HOST] = url.host
+ if url.port:
+ attrs[_PORT] = url.port
+ if url.database:
+ attrs[_DB] = url.database
+ if url.username:
+ attrs[_USER] = url.username
+ return attrs, bool(url.host)
+
+
+def _get_attributes_from_cursor(vendor, cursor, attrs):
  """Attempt to set db connection attributes by introspecting the cursor."""
- if not span.is_recording():
- return
  if vendor == "postgresql":
  # pylint: disable=import-outside-toplevel
  from psycopg2.extensions import parse_dsn
 
  if hasattr(cursor, "connection") and hasattr(cursor.connection, "dsn"):
  dsn = getattr(cursor.connection, "dsn", None)
  if dsn:
+ attrs = attrs or {}
  data = parse_dsn(dsn)
- span.set_attribute(_DB, data.get("dbname"))
- span.set_attribute(_HOST, data.get("host"))
- span.set_attribute(_PORT, int(data.get("port")))
+ attrs[_DB] = data.get("dbname")
+ attrs[_HOST] = data.get("host")
+ attrs[_PORT] = int(data.get("port"))
+ return attrs

instrumentation/opentelemetry-instrumentation-sqlalchemy/tests/test_sqlalchemy.py

@@ -35,7 +35,7 @@ def test_trace_integration(self):
  spans = self.memory_exporter.get_finished_spans()
 
  self.assertEqual(len(spans), 1)
- self.assertEqual(spans[0].name, "SELECT 1 + 1;")
+ self.assertEqual(spans[0].name, "SELECT :memory:")
  self.assertEqual(spans[0].kind, trace.SpanKind.CLIENT)
 
  def test_not_recording(self):
@@ -68,5 +68,5 @@ def test_create_engine_wrapper(self):
  spans = self.memory_exporter.get_finished_spans()
 
  self.assertEqual(len(spans), 1)
- self.assertEqual(spans[0].name, "SELECT 1 + 1;")
+ self.assertEqual(spans[0].name, "SELECT :memory:")
  self.assertEqual(spans[0].kind, trace.SpanKind.CLIENT)

tests/opentelemetry-docker-tests/tests/sqlalchemy_tests/mixins.py

@@ -110,6 +110,8 @@ def tearDown(self):
  super().tearDown()
 
  def _check_span(self, span, name):
+ if self.SQL_DB:
+ name = "{0} {1}".format(name, self.SQL_DB)
  self.assertEqual(span.name, name)
  self.assertEqual(span.attributes.get(_DB), self.SQL_DB)
  self.assertIs(span.status.status_code, trace.status.StatusCode.UNSET)
@@ -129,7 +131,7 @@ def test_orm_insert(self):
  stmt += "(?, ?)"
  else:
  stmt += "(%(id)s, %(name)s)"
- self._check_span(span, stmt)
+ self._check_span(span, "INSERT")
  self.assertIn("INSERT INTO players", span.attributes.get(_STMT))
  self.check_meta(span)
 
@@ -146,7 +148,7 @@ def test_session_query(self):
  stmt += "?"
  else:
  stmt += "%(name_1)s"
- self._check_span(span, stmt)
+ self._check_span(span, "SELECT")
  self.assertIn(
  "SELECT players.id AS players_id, players.name AS players_name \nFROM players \nWHERE players.name",
  span.attributes.get(_STMT),
@@ -163,7 +165,7 @@ def test_engine_connect_execute(self):
  spans = self.memory_exporter.get_finished_spans()
  self.assertEqual(len(spans), 1)
  span = spans[0]
- self._check_span(span, stmt)
+ self._check_span(span, "SELECT")
  self.assertEqual(span.attributes.get(_STMT), "SELECT * FROM players")
  self.check_meta(span)
 
@@ -188,4 +190,4 @@ def test_parent(self):
  self.assertEqual(parent_span.name, "sqlalch_op")
  self.assertEqual(parent_span.instrumentation_info.name, "sqlalch_svc")
 
- self.assertEqual(child_span.name, stmt)
+ self.assertEqual(child_span.name, "SELECT " + self.SQL_DB)

tests/opentelemetry-docker-tests/tests/sqlalchemy_tests/test_instrument.py

@@ -56,14 +56,14 @@ def tearDown(self):
 
  def test_engine_traced(self):
  # ensures that the engine is traced
- rows = self.conn.execute("SELECT 1").fetchall()
+ rows = self.conn.execute("SELECT").fetchall()
  self.assertEqual(len(rows), 1)
 
  traces = self.memory_exporter.get_finished_spans()
  # trace composition
  self.assertEqual(len(traces), 1)
  span = traces[0]
  # check subset of span fields
- self.assertEqual(span.name, "SELECT 1")
+ self.assertEqual(span.name, "SELECT opentelemetry-tests")
  self.assertIs(span.status.status_code, trace.status.StatusCode.UNSET)
  self.assertGreater((span.end_time - span.start_time), 0)

tests/opentelemetry-docker-tests/tests/sqlalchemy_tests/test_mysql.py

@@ -67,7 +67,7 @@ def test_engine_execute_errors(self):
  self.assertEqual(len(spans), 1)
  span = spans[0]
  # span fields
- self.assertEqual(span.name, "SELECT * FROM a_wrong_table")
+ self.assertEqual(span.name, "SELECT opentelemetry-tests")
  self.assertEqual(
  span.attributes.get(_STMT), "SELECT * FROM a_wrong_table"
  )

tests/opentelemetry-docker-tests/tests/sqlalchemy_tests/test_postgres.py

@@ -65,7 +65,7 @@ def test_engine_execute_errors(self):
  self.assertEqual(len(spans), 1)
  span = spans[0]
  # span fields
- self.assertEqual(span.name, "SELECT * FROM a_wrong_table")
+ self.assertEqual(span.name, "SELECT opentelemetry-tests")
  self.assertEqual(
  span.attributes.get(_STMT), "SELECT * FROM a_wrong_table"
  )

tests/opentelemetry-docker-tests/tests/sqlalchemy_tests/test_sqlite.py

@@ -43,7 +43,7 @@ def test_engine_execute_errors(self):
  self.assertEqual(len(spans), 1)
  span = spans[0]
  # span fields
- self.assertEqual(span.name, stmt)
+ self.assertEqual(span.name, "SELECT :memory:")
  self.assertEqual(
  span.attributes.get(_STMT), "SELECT * FROM a_wrong_table"
  )